Coderrr

Installation

Coderrr is published on PyPI as coderrr and installs as a single CLI.

Requirements

  • Python 3.10 or newer
  • pipx or uv (recommended) — a CLI belongs in its own environment
  • Optional: Docker, for the fully isolated sandbox tier

Install

pipx install coderrr

# or
uv tool install coderrr

# or, into an environment you manage yourself
pip install coderrr

No provider SDKs are pulled in — Coderrr talks to every provider over plain HTTP.

Optional extras

The only extra most people want is keyring, which moves API keys out of the config file and into your OS credential store:

pipx install 'coderrr[keyring]'
ExtraWhat it adds
keyringStores API keys in the OS keyring instead of ~/.coderrr/config.toml
openaiThe official OpenAI SDK (not required for the OpenAI provider)
anthropicThe official Anthropic SDK (not required either)
googleThe google-genai SDK (not required either)
allEvery extra above

The provider extras are conveniences for people embedding Coderrr, not prerequisites. A plain install reaches all five providers.

Verify

coderrr version
coderrr doctor

coderrr doctor reports your Python and platform, the resolved provider and model, whether an API key was found, which sandbox tier is active, and how many specs exist in the current project.

First-time setup

coderrr config

The interactive prompt asks for three things:

  • A provider — Ollama (default, no key), Anthropic, OpenAI, Google, OpenRouter
  • An API key, if the provider needs one
  • A model, chosen from that provider's suggestions

Settings land in ~/.coderrr/config.toml, created mode 0600. See Configuration for the full file format.

Upgrading

pipx upgrade coderrr

# or
uv tool upgrade coderrr

Upgrading from the npm package is a different job — see Migrating from v1.

From source

git clone https://github.com/Akash-nath29/Coderrr.git
cd Coderrr

uv sync --all-extras
uv run coderrr version

Not using uv? Pinned locks are checked in:

pip install -r requirements-dev.txt && pip install -e .