+
+
+
+Aider lets you pair program with LLMs to start a new project or build on your existing codebase. +
-
+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.
+
+
+Aider makes a map of your entire codebase, which helps it work well in larger projects.
+
+
+Aider works with most popular programming languages: python, javascript, rust, ruby, go, cpp, php, html, css, and dozens more.
+
+
+Aider automatically commits changes with sensible commit messages. Use familiar git tools to easily diff, manage and undo AI changes.
+
+
+Use aider from within your favorite IDE or editor. Ask for changes by adding comments to your code and aider will get to work.
+
+
+Add images and web pages to the chat to provide visual context, screenshots, reference docs, etc.
+
+
+Speak with aider about your code! Request new features, test cases or bug fixes using your voice and let aider implement the changes.
+
+
+Automatically lint and test your code every time aider makes changes. Aider can fix problems detected by your linters and test suites.
+
+
+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 code base
+# Change directory into your codebase
cd /to/your/project
-# Work with DeepSeek via DeepSeek's API
-aider --model deepseek --api-key deepseek=your-key-goes-here
+# DeepSeek
+aider --model deepseek --api-key deepseek=Aider has received the authentication code. " + b"You can close this browser tab.
" + ) + # Signal the main thread to shut down the server + # Signal the main thread to shut down the server + shutdown_server.set() + else: + # Redirect to aider website if 'code' is missing (e.g., user visited manually) + self.send_response(302) # Found (temporary redirect) + self.send_header("Location", urls.website) + self.end_headers() + # No need to set server_error, just redirect. + # Do NOT shut down the server here; wait for timeout or success. + else: + # Redirect anything else (e.g., favicon.ico) to the main website as well + self.send_response(302) + self.send_header("Location", urls.website) + self.end_headers() + self.wfile.write(b"Not Found") + + def log_message(self, format, *args): + # Suppress server logging to keep terminal clean + pass + + def run_server(): + nonlocal server_error + try: + with socketserver.TCPServer(("localhost", port), OAuthCallbackHandler) as httpd: + io.tool_output(f"Temporary server listening on {callback_url}", log_only=True) + server_started.set() # Signal that the server is ready + # Wait until shutdown is requested or timeout occurs (handled by main thread) + while not shutdown_server.is_set(): + httpd.handle_request() # Handle one request at a time + # Add a small sleep to prevent busy-waiting if needed, + # though handle_request should block appropriately. + time.sleep(0.1) + io.tool_output("Shutting down temporary server.", log_only=True) + except Exception as e: + server_error = f"Failed to start or run temporary server: {e}" + server_started.set() # Signal even if failed, error will be checked + shutdown_server.set() # Ensure shutdown logic proceeds + + server_thread = threading.Thread(target=run_server, daemon=True) + server_thread.start() + + # Wait briefly for the server to start, or for an error + if not server_started.wait(timeout=5): + io.tool_error("Temporary authentication server failed to start in time.") + shutdown_server.set() # Ensure thread exits if it eventually starts + server_thread.join(timeout=1) + return None + + # Check if server failed during startup + if server_error: + io.tool_error(server_error) + shutdown_server.set() # Ensure thread exits + server_thread.join(timeout=1) + return None + + # Generate codes and URL + code_verifier, code_challenge = generate_pkce_codes() + auth_url_base = "https://openrouter.ai/auth" + auth_params = { + "callback_url": callback_url, + "code_challenge": code_challenge, + "code_challenge_method": "S256", + } + auth_url = f"{auth_url_base}?{'&'.join(f'{k}={v}' for k, v in auth_params.items())}" + + io.tool_output("\nPlease open this URL in your browser to connect Aider with OpenRouter:") + io.tool_output() + print(auth_url) + + MINUTES = 5 + io.tool_output(f"\nWaiting up to {MINUTES} minutes for you to finish in the browser...") + io.tool_output("Use Control-C to interrupt.") + + try: + webbrowser.open(auth_url) + except Exception: + pass + + # Wait for the callback to set the auth_code or for timeout/error + interrupted = False + try: + shutdown_server.wait(timeout=MINUTES * 60) # Convert minutes to seconds + except KeyboardInterrupt: + io.tool_warning("\nOAuth flow interrupted.") + analytics.event("oauth_flow_failed", provider="openrouter", reason="user_interrupt") + interrupted = True + # Ensure the server thread is signaled to shut down + shutdown_server.set() + + # Join the server thread to ensure it's cleaned up + server_thread.join(timeout=1) + + if interrupted: + return None # Return None if interrupted by user + + if server_error: + io.tool_error(f"Authentication failed: {server_error}") + analytics.event("oauth_flow_failed", provider="openrouter", reason=server_error) + return None + + if not auth_code: + io.tool_error("Authentication with OpenRouter failed.") + analytics.event("oauth_flow_failed", provider="openrouter") + return None + + io.tool_output("Completing authentication...") + analytics.event("oauth_flow_code_received", provider="openrouter") + + # Exchange code for key + api_key = exchange_code_for_key(auth_code, code_verifier, io) + + if api_key: + # Set env var for the current session immediately + os.environ["OPENROUTER_API_KEY"] = api_key + + # Save the key to the oauth-keys.env file + try: + config_dir = os.path.expanduser("~/.aider") + os.makedirs(config_dir, exist_ok=True) + key_file = os.path.join(config_dir, "oauth-keys.env") + with open(key_file, "a", encoding="utf-8") as f: + f.write(f'OPENROUTER_API_KEY="{api_key}"\n') + + io.tool_warning("Aider will load the OpenRouter key automatically in future sessions.") + io.tool_output() + + analytics.event("oauth_flow_success", provider="openrouter") + return api_key + except Exception as e: + io.tool_error(f"Successfully obtained key, but failed to save it to file: {e}") + io.tool_warning("Set OPENROUTER_API_KEY environment variable for this session only.") + # Still return the key for the current session even if saving failed + analytics.event("oauth_flow_save_failed", provider="openrouter", reason=str(e)) + return api_key + else: + io.tool_error("Authentication with OpenRouter failed.") + analytics.event("oauth_flow_failed", provider="openrouter", reason="code_exchange_failed") + return None + + +# Dummy Analytics class for testing +class DummyAnalytics: + def event(self, *args, **kwargs): + # print(f"Analytics Event: {args} {kwargs}") # Optional: print events + pass + + +def main(): + """Main function to test the OpenRouter OAuth flow.""" + print("Starting OpenRouter OAuth flow test...") + + # Use a real IO object for interaction + io = InputOutput( + pretty=True, + yes=False, + input_history_file=None, + chat_history_file=None, + tool_output_color="BLUE", + tool_error_color="RED", + ) + # Use a dummy analytics object + analytics = DummyAnalytics() + + # Ensure OPENROUTER_API_KEY is not set, to trigger the flow naturally + # (though start_openrouter_oauth_flow doesn't check this itself) + if "OPENROUTER_API_KEY" in os.environ: + print("Warning: OPENROUTER_API_KEY is already set in environment.") + # del os.environ["OPENROUTER_API_KEY"] # Optionally unset it for testing + + api_key = start_openrouter_oauth_flow(io, analytics) + + if api_key: + print("\nOAuth flow completed successfully!") + print(f"Obtained API Key (first 5 chars): {api_key[:5]}...") + # Be careful printing the key, even partially + else: + print("\nOAuth flow failed or was cancelled.") + + print("\nOpenRouter OAuth flow test finished.") + + +if __name__ == "__main__": + main() diff --git a/aider/prompts.py b/aider/prompts.py index 27d833fdd..84ed75e9b 100644 --- a/aider/prompts.py +++ b/aider/prompts.py @@ -15,7 +15,7 @@ Use these for| Model Name | Total Tokens | Percent |
|---|---|---|
| claude-3-5-sonnet-20241022 | 444,178 | 45.0% |
| anthropic/claude-3-7-sonnet-20250219 | 258,397 | 26.2% |
| fireworks_ai/accounts/fireworks/models/deepseek-v3 | 105,999 | 10.7% |
| claude-3-5-haiku-20241022 | 69,203 | 7.0% |
| o3-mini | 52,192 | 5.3% |
| openrouter/anthropic/claude-3.7-sonnet | 20,213 | 2.0% |
| gpt-4o | 12,595 | 1.3% |
| openrouter/REDACTED | 12,083 | 1.2% |
| openrouter/openai/o3-mini | 10,107 | 1.0% |
| anthropic/REDACTED | 1,999 | 0.2% |
| gemini/gemini-2.5-pro-exp-03-25 | 1,637,700 | 83.1% |
| o3 | 186,953 | 9.5% |
| openrouter/anthropic/claude-3.7-sonnet | 76,285 | 3.9% |
| gemini/gemini-2.5-flash-preview-04-17 | 18,645 | 0.9% |
| gemini/gemini-2.5-pro-preview-03-25 | 16,524 | 0.8% |
| o4-mini | 16,499 | 0.8% |
| xai/grok-3-fast-beta | 10,288 | 0.5% |
| None | 8,001 | 0.4% |
| gemini/REDACTED | 606 | 0.0% |
| + + | Model | -Percent completed correctly | -Percent using correct edit format | -Command | -Edit format | -Total Cost | +Percent correct | +Cost | +Command | +Correct edit format | +Edit Format |
|---|---|---|---|---|---|---|---|---|---|---|---|
| {{ row.model }} | -{{ row.pass_rate_2 }}% | -{{ row.percent_cases_well_formed }}% | -{{ row.command }} |
- {{ row.edit_format }} | -{% if row.total_cost == 0 %}?{% else %}${{ row.total_cost | times: 1.0 | round: 2 }}{% endif %} | + {% for row in edit_sorted %} {% comment %} Add loop index for unique IDs {% endcomment %} + {% assign row_index = forloop.index0 %} +||||||
| + + + | +{{ row.model }} | ++ + {{ row.pass_rate_2 }}% + | ++ {% if row.total_cost > 0 %} + + {% endif %} + {% assign rounded_cost = row.total_cost | times: 1.0 | round: 2 %} + {% if row.total_cost == 0 or rounded_cost == 0.00 %}{% else %}${{ rounded_cost }}{% endif %} + | +{{ row.command }} |
+ {{ row.percent_cases_well_formed }}% | +{{ row.edit_format }} | +
+
By Paul Gauthier, last updated -February 26, 2025. +April 20, 2025.
diff --git a/aider/website/docs/leaderboards/refactor.md b/aider/website/docs/leaderboards/refactor.md index 96a7bea2b..50d8e3ebb 100644 --- a/aider/website/docs/leaderboards/refactor.md +++ b/aider/website/docs/leaderboards/refactor.md @@ -73,6 +73,6 @@ mod_dates = [get_last_modified_date(file) for file in files] latest_mod_date = max(mod_dates) cog.out(f"{latest_mod_date.strftime('%B %d, %Y.')}") ]]]--> -January 16, 2025. +April 12, 2025. diff --git a/aider/website/docs/legal/privacy.md b/aider/website/docs/legal/privacy.md index 1d1a2192a..1c12d245d 100644 --- a/aider/website/docs/legal/privacy.md +++ b/aider/website/docs/legal/privacy.md @@ -98,7 +98,7 @@ if result.returncode == 0: date = datetime.datetime.fromtimestamp(timestamp) cog.out(f"{date.strftime('%B %d, %Y.')}") ]]]--> -December 06, 2024. +April 12, 2025. diff --git a/aider/website/docs/llms.md b/aider/website/docs/llms.md index 4f1ec44f5..c2475431c 100644 --- a/aider/website/docs/llms.md +++ b/aider/website/docs/llms.md @@ -16,9 +16,10 @@ description: Aider can connect to most LLMs for AI pair programming. Aider works best with these models, which are skilled at editing code: +- [Gemini 2.5 Pro](/docs/llms/gemini.html) - [DeepSeek R1 and V3](/docs/llms/deepseek.html) -- [Claude 3.5 Sonnet](/docs/llms/anthropic.html) -- [OpenAI o1, o3-mini and GPT-4o](/docs/llms/openai.html) +- [Claude 3.7 Sonnet](/docs/llms/anthropic.html) +- [OpenAI o3, o4-mini and GPT-4.1](/docs/llms/openai.html) ## Free models @@ -26,10 +27,8 @@ Aider works best with these models, which are skilled at editing code: Aider works with a number of **free** API providers: -- Google's [Gemini 1.5 Pro](/docs/llms/gemini.html) works with aider, with -code editing capabilities similar to GPT-3.5. -- You can use [Llama 3 70B on Groq](/docs/llms/groq.html) which is comparable to GPT-3.5 in code editing performance. -- Cohere also offers free API access to their [Command-R+ model](/docs/llms/cohere.html), which works with aider as a *very basic* coding assistant. +- [OpenRouter offers free access to many models](https://openrouter.ai/models/?q=free), with limitations on daily usage. +- Google's [Gemini 2.5 Pro Exp](/docs/llms/gemini.html) works very well with aider. ## Local models {: .no_toc } diff --git a/aider/website/docs/llms/anthropic.md b/aider/website/docs/llms/anthropic.md index fcbb96ef9..26748b101 100644 --- a/aider/website/docs/llms/anthropic.md +++ b/aider/website/docs/llms/anthropic.md @@ -10,21 +10,26 @@ To work with Anthropic's models, you need to provide your either in the `ANTHROPIC_API_KEY` environment variable or via the `--anthropic-api-key` command line switch. -Aider has some built in shortcuts for the most popular Anthropic models and -has been tested and benchmarked to work well with them: +First, install aider: + +{% include install.md %} + +Then configure your API keys: ``` -python -m pip install -U aider-chat - export ANTHROPIC_API_KEY=+ Aider lets you pair program with LLMs to start + a new project or build on your existing + codebase. +
+ + +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.
+ + ++ Aider makes a map of your entire codebase, + which helps it work well in larger projects. +
+ + ++ Aider works with most popular programming + languages: python, javascript, rust, ruby, go, cpp, + php, html, css, and dozens more. +
+ + ++ Aider automatically commits changes with + sensible commit messages. + Use familiar git tools to easily + diff, manage and undo AI changes. +
+ + ++ Use aider from within your favorite IDE or editor. + Ask for changes by adding comments to + your code and aider will get to work. +
+ + ++ Add images and web pages to the chat to + provide visual context, screenshots, reference docs, + etc. +
+ + ++ Speak with aider about your code! Request new features, + test cases or bug fixes using your voice and let aider + implement the changes. +
+ + ++ Automatically lint and test your code every time aider makes changes. + Aider can fix problems detected by your linters and test suites. +
+ + ++ Aider works best with LLM APIs, + but it can also work an LLM via its web chat interface. + Aider streamlines copy/pasting code + back and forth with a browser. +
+ +
- 
- 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>Want more details?
+ +Everything you need to get started and make the most of Aider
+ +Connect with other users and find additional resources
+ +- -
- - - - -## Getting started - - -If you already have python 3.8-3.13 installed, you can get started quickly like this: - -```bash -python -m pip install aider-install -aider-install - -# Change directory into your code base -cd /to/your/project - -# Work with DeepSeek via DeepSeek's API -aider --model deepseek --api-key deepseek=your-key-goes-here - -# Work with Claude 3.5 Sonnet via Anthropic's API -aider --model sonnet --api-key anthropic=your-key-goes-here - -# Work with GPT-4o via OpenAI's API -aider --model gpt-4o --api-key openai=your-key-goes-here - -# Work with Sonnet via OpenRouter's API -aider --model openrouter/anthropic/claude-3.5-sonnet --api-key openrouter=your-key-goes-here - -# Work with DeepSeek via OpenRouter's API -aider --model openrouter/deepseek/deepseek-chat --api-key openrouter=your-key-goes-here -``` - - -See the -[installation instructions](https://aider.chat/docs/install.html) -and -[usage documentation](https://aider.chat/docs/usage.html) -for more details. - -## Features - -- Run aider with the files you want to edit: `aider