aider README

The project's README from github.com/Aider-AI/aider. As one markdown file: README.md.

Aider Logo

AI Pair Programming in Your Terminal

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

aider screencast

GitHub Stars PyPI Downloads Tokens per week OpenRouter Ranking Singularity

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

python -m pip install aider-install
aider-install

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

# DeepSeek
aider --model deepseek --api-key deepseek=<key>

# Claude 3.7 Sonnet
aider --model sonnet --api-key anthropic=<key>

# o3-mini
aider --model o3-mini --api-key openai=<key>

See the installation instructions and usage documentation for more details.

More Information

Documentation

Community & Resources

Kind Words From Users

aider (Aider-AI/aider)

gpt-4
Searching Databaseโ€ฆ

49.6K ยทGitHub
What is this?Aider is an AI pair programming tool that runs in your terminal, letting you chat with an LLM to build new projects or edit an existing codebase.
Is this a CLI tool or does it live inside my editor?It is primarily a command-line tool you run in a terminal, but it can also be invoked from within your IDE or editor by adding comments to your code for aider to act on.
How do I get it running?Install it and follow the official Installation Guide and Usage documentation linked from the README to connect it to an LLM and start chatting with your codebase.
Do I need an API key for a specific LLM provider?Aider works best with Claude 3.7 Sonnet, DeepSeek R1 & Chat V3, OpenAI o1/o3-mini/GPT-4o, but it can connect to almost any cloud or local LLM, so you need credentials for whichever provider you choose.
Does it work with any programming language, or just a few?It supports most popular languages including Python, JavaScript, Rust, Ruby, Go, C++, PHP, HTML, and CSS, plus dozens more.
Which operating systems does it run on?It runs cross-platform on Linux, macOS, and Windows, since it's a Python terminal application.
Does aider manage git commits for me?Yes, aider automatically commits changes it makes with sensible commit messages, so you can diff, manage, and undo its edits using familiar git tools.
Can I give it screenshots or web pages for context?Yes, you can add images and web pages to the chat to give aider visual context, such as screenshots or reference docs.
Can I code by talking instead of typing?Yes, aider supports voice-to-code: you can speak requests for new features, test cases, or bug fixes and aider will implement the changes.
Does it help with linting and testing?Aider can automatically lint and test your code after every change and attempt to fix any problems its linters or test suites detect.
Creator
Aider-AI
Size
137.1 MB
Stars
49.6K
Age
3y
Commits ยท 90 Days