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
Complete guide. Scroll
01
[REQUIREMENTS]STEP 01 / 04

System requirements

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

shell
$python3 --version
02
[PROVIDER]STEP 02 / 04

Choose a provider

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

shell
$eva use groq
03
[CREDENTIALS]STEP 03 / 04

Store your API key

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"

04
[VERIFICATION]STEP 04 / 04

Run the system doctor

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

shell
$eva config doctor