Installation & API keys

pip install visvoai-cli
export GEMINI_API_KEY=...
visvoai

API keys

Any of these, per provider — highest wins, nothing is ever committed:

1. Environment — export GEMINI_API_KEY=… (or ANTHROPIC_API_KEY, OPENAI_API_KEY, GROQ_API_KEY, … — the {PROVIDER}_API_KEY convention, including anything a local .env provides).
2. Per-project — /login in the TUI, or edit <project>/.visvoai/secrets.toml ([api_keys]); written 0600 and auto-added to the project's .gitignore.
3. Global default — ~/.visvoai/config.toml ([api_keys]), used everywhere unless a project overrides it.

You need exactly one key to start; add more providers any time and the /model picker lights them up. One exception: web search and web fetch are Gemini-grounded, so those two tools need a GEMINI_API_KEY even when you chat through another provider.

See Model picker for how the catalog behind /model is built and kept current.