Installation

Prerequisites

• Python 3.11 or higher
• A git repository (Nimbus needs to read and write code)
• An Anthropic API key
• A Voyage AI API key

Install via pip

The primary installation path:

pip install nimbus-ai

Verify the installation:

nimbus --version
# nimbus 1.1.0

Install via curl

curl -fsSL https://get-nimbus.com/install.sh | bash

Install via Homebrew

brew tap arpjw/tap
brew install nimbus

Optional: voice support

To use nimbus --voice, install the voice extras:

pip install nimbus-ai[voice]

This adds sounddevice, numpy, scipy, and openai-whisper.

Getting API keys

Anthropic — Create an account at console.anthropic.com, navigate to API Keys, and create a new key. Nimbus uses Claude Opus for planning and Claude Sonnet for implementation.

Voyage AI — Create an account at dash.voyageai.com and create a new API key. Nimbus uses the voyage-code-2 model to embed your codebase.

Once you have both keys, set them as environment variables:

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

Or add them to ~/.nimbus/config.toml — see Configuration.