README

AI Pair Programming in Your Terminal




Aider lets you pair program with LLMs to start a new project or build on your existing codebase. 



  




  
  
  
  
  
  


 Features

 Cloud and local LLMs


Aider works best with Claude 3.7 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1, o3-mini & GPT-4o, but can connect to almost any LLM, including local models.



 Maps your codebase


Aider makes a map of your entire codebase, which helps it work well in larger projects.



 100+ code languages


Aider works with most popular programming languages: python, javascript, rust, ruby, go, cpp, php, html, css, and dozens more.



 Git integration


Aider automatically commits changes with sensible commit messages. Use familiar git tools to easily diff, manage and undo AI changes.



 Use in your IDE


Use aider from within your favorite IDE or editor. Ask for changes by adding comments to your code and aider will get to work.



 Images & web pages


Add images and web pages to the chat to provide visual context, screenshots, reference docs, etc.



 Voice-to-code


Speak with aider about your code! Request new features, test cases or bug fixes using your voice and let aider implement the changes.



 Linting & testing


Automatically lint and test your code every time aider makes changes. Aider can fix problems detected by your linters and test suites.



 Copy/paste to web chat


Work with any LLM via its web chat interface. Aider streamlines copy/pasting code context and edits back and forth with a browser.

 Getting Started

bash
python -m pip install aider-install
aider-install

 Change directory into your codebase
cd /to/your/project

 DeepSeek
aider --model deepseek --api-key deepseek=

 Claude 3.7 Sonnet
aider --model sonnet --api-key anthropic=

 o3-mini
aider --model o3-mini --api-key openai=


See the installation instructions and usage documentation for more details.

 More Information

 Documentation
- Installation Guide
- Usage Guide
- Tutorial Videos
- Connecting to LLMs
- Configuration Options
- Troubleshooting
- FAQ

 Community & Resources
- LLM Leaderboards
- GitHub Repository
- Discord Community
- Release notes
- Blog

 Kind Words From Users

- "My life has changed... Aider... It's going to rock your world." — Eric S. Raymond on X
- "The best free open source AI coding assistant." — IndyDevDan on YouTube
- "The best AI coding assistant so far." — Matthew Berman on YouTube
- "Aider ... has easily quadrupled my coding productivity." — SOLAR_FIELDS on Hacker News
- "It's a cool workflow... Aider's ergonomics are perfect for me." — qup on Hacker News
- "It's really like having your senior developer live right in your Git repo - truly amazing!" — rappster on GitHub
- "What an amazing tool. It's incredible." — valyagolev on GitHub
- "Aider is such an astounding thing!" — cgrothaus on GitHub
- "It was WAY faster than I would be getting off the ground and making the first few working versions." — Daniel Feldman on X
- "THANK YOU for Aider! It reall

Top issues

Latest release

- Added support for all GPT-5 models.
- Added support for Grok-4 via xai/grok-4 and openrouter/x-ai/grok-4 model names.
- Added support for gemini/gemini-2.5-flash-lite-preview-06-17 model, by Tamir Zahavi-Brunner.
- /clear now prints “All chat history cleared.” so you know it worked, by Zexin Yuan.
- /undo output now shows only the first line of each commit message, making it easier to read.
- Added support for openrouter/moonshotai/kimi-k2 model, by Jack Harrington.
- Display model announcements with no-arg /model command.
- Fixed an issue where new settings for an existing model didn