agent
Open source
free (BYO API key)
4.6/5

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.

By Eruo Fredoline·Last verified Nov 8, 2026·49,981 GitHub stars

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.

Aider ↔ ecosystem

Recommended stack

  • Commonly deployed with
    Ollama

    Aider works fluently against Ollama for single-user coding workflows. No MCP layer needed; Aider talks to git directly.

Alternatives

  • Competes with
    OpenHands

    OpenHands is full agent loop; Aider is git-integrated CLI editor. Different paradigms — Aider for surgical edits, OpenHands for autonomous tasks.

  • Alternative to
    OpenHands

    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)
LicenseOpen 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.

Active
Updated Nov 8, 2026

8 days since last refresh · source: lastUpdated

Benchmark freshness

How recent the editorial measurements on this runtime are.

0editorial benchmarks

No editorial benchmarks for this runtime yet.

Community reproduction

Submissions that match an editorial measurement on similar hardware.

0reproduced reports

No community reproductions on file yet.

Ecosystem stability

Editorial rating from RunLocalAI — qualitative, not measured.

4.6/5Editorial

Get Aider

Frequently asked

Is Aider free?

Yes — Aider is free to use and open-source.

What operating systems does Aider support?

Aider supports macOS, Linux, Windows.

Does Aider need a GPU?

No — Aider runs on CPU; it does not require or use a GPU.

Reviewed by RunLocalAI Editorial. See our editorial policy for how we evaluate tools.

Related — keep moving

Recommended hardware
Before you buy

Verify Aider runs on your specific hardware before committing money.