Eva

Command-line intelligence for users — seamless model routing with zero browser context switching.

shell

$curl -fsSL https://raw.githubusercontent.com/rootagi/eva/main/install.sh | sh

[INSTALLATION]STEP 01 / 07

Install the Eva package directly via pip3.

shell

$pip3 install eva-cli

[REQUIREMENTS]STEP 02 / 07

Eva requires Python 3.10 or higher, or skip local setup entirely and run it through Docker.

shell

$python3 --version

[EVA FAST]STEP 03 / 07

Install the optional Rust-accelerated `eva-fastwalk` extension for hyper-fast directory traversal.

shell

$uv tool install "eva-cli[fast]"

$pip install --user "eva-cli[fast]"

$pipx install "eva-cli[fast]"

[PROVIDER]STEP 04 / 07

Point Eva at a free-tier cloud provider or a fully offline local backend. OpenRouter is the default.

shell

$eva use groq

[CREDENTIALS]STEP 05 / 07

Save your provider's key to the system keyring, or export it as an environment variable on headless machines.

shell

$eva config set-key groq

# Headless environment variables

export EVA_GROQ_API_KEY="your_key_here"

export EVA_OPENROUTER_API_KEY="your_key_here"

export EVA_GEMINI_API_KEY="your_key_here"

export EVA_OPENCODE_ZEN_API_KEY="your_key_here"

[VERIFICATION]STEP 06 / 07

A diagnostic check across your keyring, provider endpoints, and local tools, confirms everything is wired up.

shell

$eva config doctor

[SHELL COMPLETION]STEP 07 / 07

Enable tab auto-completion for Bash, Zsh, or Fish shells. This registers Eva's commands and flags in your shell's completion system.

shell

$eva --install-completion