Aider
Terminal-based AI pair programmer. Run in your project directory, describe a change, it edits files and creates meaningful git commits. Works with any LLM — local Ollama, Anthropic, OpenAI, etc.
Overview
Terminal-based AI pair programmer. Run in your project directory, describe a change, it edits files and creates meaningful git commits. Works with any LLM — local Ollama, Anthropic, OpenAI, etc.
Setup guidance
Install via pip: pip install aider-chat. Or with uv: uv tool install aider-chat. Requires Python 3.10 to 3.12. Aider is a terminal-based AI pair programming tool that edits code in your local git repo. You need an LLM API key — OpenAI, Anthropic, or a local model via OpenAI-compatible endpoint. Configure: export OPENAI_API_KEY=sk-... or export ANTHROPIC_API_KEY=sk-ant-.... For local models: aider --model openai/<model-name> --openai-api-base http://localhost:11434/v1. Run in your git repo: cd /path/to/project && aider. Aider's prompt accepts natural language instructions like "add a login endpoint with JWT auth" and edits files directly. It maintains a map of your repo in context (using tree-sitter for code parsing) and auto-commits changes with sensible messages. Verify it works: aider --message "Explain what this project does".
Workload fit
Best for: terminal-native developers who want AI pair programming with git-native workflows, tactical code edits (refactoring, adding features, fixing bugs) with natural language instructions, developers who want to use any LLM (cloud API or local) with the same tool, multi-file editing with automatic git commits, PR review and generation workflows, any workflow where "AI edits, I review git diffs" is the desired pattern. Not suited for: non-developers (Aider requires terminal and git literacy), IDE-first developers who prefer GUI integration (use Cline or Cursor), projects without git version control (Aider's core workflow depends on git), full-codebase generation from zero (use agentic tools like Claude Code for greenfield generation).
Alternatives
Use Aider when you want AI pair programming from the terminal with direct file editing and git integration — it's the most git-aware AI code assistant and works with any LLM (local or API). Switch to Claude Code when you want an agentic coding experience with tool use, multi-step reasoning, and broader file operations — Aider is a pair programmer, Claude Code is an autonomous agent. Use Cline for VS Code-integrated AI coding with full project awareness — Aider is terminal-native. Use Continue for inline VS Code/JetBrains completions and chat alongside your IDE workflow. Use Cursor for an all-in-one AI-native IDE. Aider's strength is the git workflow: every change is a commit, every request operates on the repo, and you can undo AI changes with git revert. It's the best choice for developers who want AI-on-the-CLI with their existing toolchain.
Troubleshooting + when to switch
Problem: API Error: model requires authentication. Fix: Set the correct API key env var for your provider: OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, etc. Load keys from a specific file with --env-file filename.env if needed. For local models via Ollama, ensure ollama serve is running and the OpenAI API base URL is correct: --openai-api-base http://localhost:11434/v1. Problem: Repo map generation causes high token usage and slow first responses. Fix: Aider builds a tree-sitter parse map of the entire repo. For large repos, tune the budget with --map-tokens (default 1k tokens). Add files to .aiderignore to exclude generated or vendor code. Use --map-tokens 0 to skip repo mapping entirely for simple, targeted edits. Problem: Aider edits the wrong file or makes unrelated changes. Fix: Be specific about file paths: "in src/auth.py, add..." Directories help: --file src/auth.py to focus Aider's editing scope. Use /read-only in the Aider prompt for files it should reference but not modify. Review diffs with /diff before accepting.
Stack & relationships
How Aider relates to other entries in the catalog — recommended pairings, alternatives, dependencies, and edges to avoid. Each edge carries a one-line operator note from our editorial team.
Recommended stack
- Commonly deployed withOllama
Aider works fluently against Ollama for single-user coding workflows. No MCP layer needed; Aider talks to git directly.
Alternatives
- Competes withOpenHands
OpenHands is full agent loop; Aider is git-integrated CLI editor. Different paradigms — Aider for surgical edits, OpenHands for autonomous tasks.
- Alternative toOpenHands
Different paradigms. Aider is git-integrated CLI editor; OpenHands is autonomous task agent. Pick Aider for surgical commits, OpenHands for autonomous work.
Pros
- Open source
- BYO LLM (local OK)
- Git-aware diffs
- Mature project
Cons
- Terminal-first (browser UI is experimental)
- Quality scales with the underlying model
Compatibility
| Operating systems | macOS Linux Windows |
| GPU backends | n/a (uses cloud or local API) |
| License | Open source · free (BYO API key) |
Runtime health
Operator-grade signals on how actively Aider is being maintained, how fresh its measurements are, and what failure classes operators have flagged. Every label below is anchored to a real date or count — we never infer maintainer activity we can't show.
Release cadence
Derived from the most recent editorial signal on this row.
8 days since last refresh · source: lastUpdated
Benchmark freshness
How recent the editorial measurements on this runtime are.
No editorial benchmarks for this runtime yet.
Community reproduction
Submissions that match an editorial measurement on similar hardware.
No community reproductions on file yet.
Ecosystem stability
Editorial rating from RunLocalAI — qualitative, not measured.
Get Aider
Frequently asked
Is Aider free?
What operating systems does Aider support?
Does Aider need a GPU?
Reviewed by RunLocalAI Editorial. See our editorial policy for how we evaluate tools.
Related — keep moving
Verify Aider runs on your specific hardware before committing money.