Skip to Content

Aider

A terminal pair-programmer: you name the files, it edits them and commits each change with a tidy message. Less autonomous than the other tools here — and often the right trade when you want the model close to the code but the initiative to stay with you.

Install

pip install aider-chat

Python 3.10 or newer is recommended.

pip often prints a warning like “The script aider is installed in ~/.local/bin which is not on PATH”. Read that line — it names the exact directory — and add it:

export PATH=$HOME/.local/bin:$PATH

Persist it in ~/.zshrc or ~/.bashrc, otherwise aider will not be found in a new shell.

Configure

export OPENAI_API_BASE=https://api.devotel.com/v1 export OPENAI_API_KEY=dvt-YOUR_KEY

Run it in a repository

cd ~/code/my-project aider --model openai/kimi-k3

The openai/ prefix tells Aider to use its OpenAI-compatible client, which is what makes OPENAI_API_BASE apply. Without it, Aider tries to guess the provider from the model name.

Using it

Add the files you want it to work on, describe the change, and it edits them and commits:

$ aider --model openai/kimi-k3 > /add src/parser.py tests/test_parser.py > handle the human-readable size suffixes (12Gi, 400M) in parse_size src/parser.py tests/test_parser.py Applied edit to src/parser.py Applied edit to tests/test_parser.py Commit 4f1c9ab parse human-readable size suffixes in parse_size

One commit per change keeps the history reviewable and makes any single step easy to undo with git revert. For scratch work outside a repository — or when you would rather commit yourself:

aider --no-git --model openai/kimi-k3

Aider is a pair-programmer, not a fully autonomous agent. It edits and commits, but it will not go off and run your test suite in a loop deciding what to do next. For that, use OpenHarness or OpenCode.

Troubleshooting

SymptomCause and fix
aider: command not foundThe directory from pip’s PATH warning is not on PATH
Requests go to OpenAIOPENAI_API_BASE unset, or the model given without the openai/ prefix
401OPENAI_API_KEY is not your dvt- key
404 / model_not_foundUse openai/kimi-k3 exactly
Commits you did not wantRun with --no-git, or use /undo in the session