# Aider Documentation Aider is AI pair programming in your terminal. This documentation will help you get the most out of aider. ## Installation - [Installation](/content/docs/install.html)— How to install and get started pair programming with aider. - [Optional steps](/content/docs/install/optional.html) - [Aider with docker](/content/docs/install/docker.html) - [GitHub Codespaces](/content/docs/install/codespaces.html) - [Replit](/content/docs/install/replit.html) ## Usage - [Usage](/content/docs/usage.html)— How to use aider to pair program with AI and edit code in your local git repo. - [Tips](/content/docs/usage/tips.html)— Tips for AI pair programming with aider. - [In-chat commands](/content/docs/usage/commands.html)— Control aider with in-chat commands like /add, /model, etc. - [Chat modes](/content/docs/usage/modes.html)— Using the code, architect, ask and help chat modes. - [Tutorial videos](/content/docs/usage/tutorials.html)— Intro and tutorial videos made by aider users. - [Voice-to-code with aider](/content/docs/usage/voice.html)— Speak with aider about your code! - [Images & web pages](/content/docs/usage/images-urls.html)— Add images and web pages to the aider coding chat. - [Prompt caching](/content/docs/usage/caching.html)— Aider supports prompt caching for cost savings and faster coding. - [Aider in your IDE](/content/docs/usage/watch.html)— Aider can watch your files and respond to AI comments you add in your favorite IDE or text editor. - [Notifications](/content/docs/usage/notifications.html)— Aider can notify you when it's waiting for your input. - [Aider in your browser](/content/docs/usage/browser.html)— Aider can run in your browser, not just on the command line. - [Specifying coding conventions](/content/docs/usage/conventions.html)— Tell aider to follow your coding conventions when it works on your code. - [Copy/paste with web chat](/content/docs/usage/copypaste.html)— Aider works with LLM web chat UIs - [Linting and testing](/content/docs/usage/lint-test.html)— Automatically fix linting and testing errors. - [Editing config & text files](/content/docs/usage/not-code.html)— Use aider to edit configuration files, documentation, and other text-based formats. ## Connecting to LLMs - [Connecting to LLMs](/content/docs/llms.html)— Aider can connect to most LLMs for AI pair programming. - [OpenAI](/content/docs/llms/openai.html) - [Anthropic](/content/docs/llms/anthropic.html) - [Gemini](/content/docs/llms/gemini.html) - [GROQ](/content/docs/llms/groq.html) - [LM Studio](/content/docs/llms/lm-studio.html) - [xAI](/content/docs/llms/xai.html) - [Azure](/content/docs/llms/azure.html) - [Cohere](/content/docs/llms/cohere.html) - [DeepSeek](/content/docs/llms/deepseek.html) - [Ollama](/content/docs/llms/ollama.html) - [OpenAI compatible APIs](/content/docs/llms/openai-compat.html) - [OpenRouter](/content/docs/llms/openrouter.html) - [GitHub Copilot](/content/docs/llms/github.html) - [Vertex AI](/content/docs/llms/vertex.html) - [Amazon Bedrock](/content/docs/llms/bedrock.html) - [Other LLMs](/content/docs/llms/other.html) - [Model warnings](/content/docs/llms/warnings.html) ## Configuration - [Configuration](/content/docs/config.html)— Information on all of aider's settings and how to use them. - [API Keys](/content/docs/config/api-keys.html)— Setting API keys for API providers. - [Options reference](/content/docs/config/options.html)— Details about all of aider's settings. - [YAML config file](/content/docs/config/aider_conf.html)— How to configure aider with a YAML config file. - [Config with .env](/content/docs/config/dotenv.html)— Using a .env file to store LLM API keys for aider. - [Editor configuration](/content/docs/config/editor.html)— How to configure a custom editor for aider's /editor command - [Reasoning models](/content/docs/config/reasoning.html)— How to configure reasoning model settings from secondary providers. - [Advanced model settings](/content/docs/config/adv-model-settings.html)— Configuring advanced settings for LLMs. - [Model Aliases](/content/docs/config/model-aliases.html)— Assign convenient short names to models. ## Troubleshooting - [Troubleshooting](/content/docs/troubleshooting.html)— How to troubleshoot problems with aider and get help. - [File editing problems](/content/docs/troubleshooting/edit-errors.html) - [Model warnings](/content/docs/troubleshooting/warnings.html) - [Token limits](/content/docs/troubleshooting/token-limits.html) - [Aider not found](/content/docs/troubleshooting/aider-not-found.html) - [Dependency versions](/content/docs/troubleshooting/imports.html) - [Models and API keys](/content/docs/troubleshooting/models-and-keys.html) - [Using /help](/content/docs/troubleshooting/support.html) ## Screen recordings - [Screen recordings](/content/docs/recordings/index.html)— Screen recordings of aider building aider. - [Add language support via tree-sitter-language-pack](/content/docs/recordings/tree-sitter-language-pack.html)— Watch how aider adds support for tons of new programming languages by integrating with tree-sitter-language-pack. Demonstrates using aider to script downloading a collection of files, and using ad-hoc bash scripts to have aider modify a collection of files. - [Add –auto-accept-architect feature](/content/docs/recordings/auto-accept-architect.html)— See how a new command-line option is added to automatically accept edits proposed by the architect model, with implementation. Aider also updates the project's HISTORY file. - [Don’t /drop read-only files added at launch](/content/docs/recordings/dont-drop-original-read-files.html)— Follow along as aider is modified to preserve read-only files specified at launch when using the /drop command. Aider does this implementation and adds test coverage. - [Warn when users apply unsupported reasoning settings](/content/docs/recordings/model-accepts-settings.html)— Watch the implementation of a warning system that alerts users when they try to apply reasoning settings to models that don't support them. Includes adding model metadata, confirmation dialogs, refactoring, and comprehensive test coverage. ## Example chat transcripts - [Example chat transcripts](/content/examples/README.html) - [Editing an asciinema cast file with aider](/content/examples/asciinema.html) - [Download, analyze and plot US Census data](/content/examples/census.html) - [Improve css styling of chat transcripts](/content/examples/chat-transcript-css.html) - [Complete a css exercise with aider](/content/examples/css-exercises.html) - [Hello aider!](/content/examples/hello.html) - [Honor the NO_COLOR environment variable](/content/examples/no-color.html) - [Build pong with aider and pygame.](/content/examples/pong.html) - [Semantic search & replace code with aider](/content/examples/semantic-search-replace.html) - [Automatically update docs with aider](/content/examples/update-docs.html) - [Create a simple flask app with aider](/content/examples/hello-world-flask.html) - [Modify an open source 2048 game with aider](/content/examples/2048-game.html) - [A complex multi-file change, with debugging](/content/examples/complex-change.html) - [Create a “black box” test case](/content/examples/add-test.html) ## More info - [More info](/content/docs/more-info.html) - [Git integration](/content/docs/git.html)— Aider is tightly integrated with git. - [Supported languages](/content/docs/languages.html)— Aider supports pretty much all popular coding languages. - [Repository map](/content/docs/repomap.html)— Aider uses a map of your git repository to provide code context to LLMs. - [Scripting aider](/content/docs/scripting.html)— You can script aider via the command line or python. - [Infinite output](/content/docs/more/infinite-output.html)— Aider can handle "infinite output" from models that support prefill. - [Edit formats](/content/docs/more/edit-formats.html)— Aider uses various "edit formats" to let LLMs edit source files. - [Analytics](/content/docs/more/analytics.html)— Opt-in, anonymous, no personal info. - [Privacy policy](/content/docs/legal/privacy.html) ## FAQ - [FAQ](/content/docs/faq.html)— Frequently asked questions about aider. ## Release history - [Release history](/content/HISTORY.html)— Release notes and stats on aider writing its own code. ## Aider LLM Leaderboards - [Aider LLM Leaderboards](/content/docs/leaderboards/index.html)— Quantitative benchmarks of LLM code editing skill. - [Code editing leaderboard](/content/docs/leaderboards/edit.html)— Quantitative benchmark of basic LLM code editing skill. - [Refactoring leaderboard](/content/docs/leaderboards/refactor.html)— Quantitative benchmark of LLM code refactoring skill. - [Scores by release date](/content/docs/leaderboards/by-release-date.html) - [Benchmark notes](/content/docs/leaderboards/notes.html) - [Contributing results](/content/docs/leaderboards/contrib.html) ## Aider blog - [Aider blog](/content/blog/index.html)