Install Nimbus

Get started in two minutes.

Nimbus runs locally on your machine using your own API keys. Python 3.11+ required.

pip install nimbus-ai

Choose your install method

1

Install the package

bash
pip install nimbus-ai
2

Set your API keys

Nimbus uses Anthropic for reasoning and Voyage AI for embeddings. Both have free tiers.

bash
export ANTHROPIC_API_KEY=sk-ant-...
export VOYAGE_API_KEY=pa-...

Add to ~/.zshrc or ~/.bashrc to persist across sessions.

3

Run in your project

bash
cd your-project
nimbus

Get your API keys

Anthropic

Free tier available

Powers the planning and implementation agents. Claude Opus for planning, Claude Sonnet for implementation.

ANTHROPIC_API_KEY
Get key →

Voyage AI

50M tokens free/month

Generates code embeddings for RAG retrieval. voyage-code-2 model, purpose-built for source code.

VOYAGE_API_KEY
Get key →

Optional extras

Voice input
pip install nimbus-ai[voice]

Speak your tasks. Requires mic access. Uses local Whisper (base model).

Soundtrack
pip install nimbus-ai[sound]

Audio feedback for task start, verify pass, complete, and failed states.

Both
pip install nimbus-ai[voice,sound]

Voice input and soundtrack together.

Verify your install

bash
nimbus --version\n# nimbus 1.1.0

If Nimbus is installed but keys are missing, it will show a setup panel guiding you through the configuration. Run nimbus in any git repo to start the REPL.

What's next

Explore built-in agents

20 pre-configured agents for security, testing, docs, and more. Run any agent with nimbus run --agent <name>.

Read the docs →

Install the Chrome Extension

Review with Nimbus on every GitHub PR. Implement with Nimbus on every issue. No terminal needed.

Read the docs →

Set up GitHub Actions

Automatic code review on every PR, security scanning, test generation — all from CI.

Read the docs →

Nimbus v1.1.0 · MIT License · PyPI · GitHub