cecli-dev 0.93.1__py3-none-any.whl

cecli/website/docs/llms/anthropic.md

@@ -0,0 +1,77 @@
+---
+parent: Connecting to LLMs
+nav_order: 200
+---
+
+# Anthropic
+
+To work with Anthropic's models, you need to provide your
+[Anthropic API key](https://docs.anthropic.com/claude/reference/getting-started-with-the-api)
+either in the `ANTHROPIC_API_KEY` environment variable or
+via the `--anthropic-api-key` command line switch.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```
+export ANTHROPIC_API_KEY=<key> # Mac/Linux
+setx   ANTHROPIC_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and Anthropic on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+# Aider uses Claude 3.7 Sonnet by default
+aider
+
+# List models available from Anthropic
+aider --list-models anthropic/
+```
+
+{: .tip }
+Anthropic has very low rate limits. 
+You can access all the Anthropic models via
+[OpenRouter](openrouter.md)
+or [Google Vertex AI](vertex.md)
+with more generous rate limits.
+
+You can use `aider --model <model-name>` to use any other Anthropic model.
+For example, if you want to use a specific version of Opus
+you could do `aider --model claude-3-opus-20240229`.
+
+## Thinking tokens
+
+Aider can work with Sonnet 3.7's new thinking tokens, but does not ask Sonnet to use
+thinking tokens by default.
+
+Enabling thinking currently requires manual configuration.
+You need to add the following to your `.aider.model.settings.yml` 
+[model settings file](/docs/config/adv-model-settings.html#model-settings).
+Adjust the `budget_tokens` value to change the target number of thinking tokens.
+
+```yaml
+- name: anthropic/claude-3-7-sonnet-20250219
+  edit_format: diff
+  weak_model_name: anthropic/claude-3-5-haiku-20241022
+  use_repo_map: true
+  examples_as_sys_msg: true
+  use_temperature: false
+  extra_params:
+    extra_headers:
+      anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19
+    max_tokens: 64000
+    thinking:
+      type: enabled
+      budget_tokens: 32000 # Adjust this number
+  cache_control: true
+  editor_model_name: anthropic/claude-3-7-sonnet-20250219
+  editor_edit_format: editor-diff
+```
+
+More streamlined support will be coming soon.

cecli/website/docs/llms/azure.md

@@ -0,0 +1,48 @@
+---
+parent: Connecting to LLMs
+nav_order: 500
+---
+
+# Azure
+
+Aider can connect to the OpenAI models on Azure.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys and endpoint:
+
+```
+# Mac/Linux:                                           
+export AZURE_API_KEY=<key>
+export AZURE_API_VERSION=2024-12-01-preview
+export AZURE_API_BASE=https://myendpt.openai.azure.com
+
+# Windows
+setx AZURE_API_KEY <key>
+setx AZURE_API_VERSION 2024-12-01-preview
+setx AZURE_API_BASE https://myendpt.openai.azure.com
+# ... restart your shell after setx commands
+```
+
+Start working with aider and Azure on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+aider --model azure/<your_model_deployment_name>
+
+# List models available from Azure
+aider --list-models azure/
+```
+
+Note that aider will also use environment variables
+like `AZURE_OPENAI_API_xxx`.
+
+The `aider --list-models azure/` command will list all models that aider supports through Azure, not the models that are available for the provided endpoint.
+
+When setting the model to use with `--model azure/<your_model_deployment_name>`, `<your_model_deployment_name>` is likely just the name of the model you have deployed to the endpoint for example `o3-mini` or `gpt-4o`.  The screenshow below shows `o3-mini` and `gpt-4o` deployments in the Azure portal done under the `myendpt` resource.
+
+![example azure deployment](/assets/azure-deployment.png)

cecli/website/docs/llms/bedrock.md

@@ -0,0 +1,132 @@
+---
+parent: Connecting to LLMs
+nav_order: 560
+---
+
+# Amazon Bedrock
+
+Aider can connect to models provided by Amazon Bedrock.
+To configure Aider to use the Amazon Bedrock API, you need to set up your AWS credentials.
+This can be done using the AWS CLI or by setting environment variables.
+
+## Select a Model from Amazon Bedrock
+
+Before you can use a model through Amazon Bedrock, you must "enable" the model under the **Model
+Access** screen in the AWS Management Console.
+To find the `Model ID`, open the **Model Catalog** area in the Bedrock console, select the model 
+you want to use, and the find the `modelId` property under the "Usage" heading.
+
+### Bedrock Inference Profiles
+
+Amazon Bedrock has added support for a new feature called [cross-region "inference profiles."](https://aws.amazon.com/about-aws/whats-new/2024/09/amazon-bedrock-knowledge-bases-cross-region-inference/)
+Some models hosted in Bedrock _only_ support these inference profiles.
+If you're using one of these models, then you will need to use the `Inference Profile ID` 
+instead of the `Model ID` from the **Model Catalog** screen, in the AWS Management Console.
+For example, the Claude Sonnet 3.7 model, release in February 2025, exclusively supports
+inference through inference profiles. To use this model, you would use the 
+`us.anthropic.claude-3-7-sonnet-20250219-v1:0` Inference Profile ID.
+In the Amazon Bedrock console, go to Inference and Assessment ➡️ Cross-region Inference
+to find the `Inference Profile ID` value.
+
+If you attempt to use a `Model ID` for a model that exclusively supports the Inference Profile
+feature, you will receive an error message like the following:
+
+> litellm.BadRequestError: BedrockException - b'{"message":"Invocation of model ID
+anthropic.claude-3-7-sonnet-20250219-v1:0 with on-demand throughput isn\xe2\x80\x99t supported. Retry your
+request with the ID or ARN of an inference profile that contains this model."}'
+
+## Installation and Configuration
+
+First, install aider:
+
+{% include install.md %}
+
+Next, configure your AWS credentials. This can be done using the AWS CLI or by setting environment variables.
+
+## AWS CLI Configuration
+
+If you haven't already, install the [AWS CLI](https://aws.amazon.com/cli/) and configure it with your credentials:
+
+```bash
+aws configure
+```
+
+This will prompt you to enter your AWS Access Key ID, Secret Access Key, and default region.
+
+## Environment Variables
+
+You can set the following environment variables:
+
+```bash
+export AWS_REGION=your_preferred_region
+
+# For user authentication
+export AWS_ACCESS_KEY_ID=your_access_key
+export AWS_SECRET_ACCESS_KEY=your_secret_key
+
+# For profile authentication
+export AWS_PROFILE=your-profile
+```
+
+You can add these to your 
+[.env file](/docs/config/dotenv.html).
+
+### Set Environment Variables with PowerShell
+
+If you're using PowerShell on MacOS, Linux, or Windows, you can set the same AWS configuration environment variables with these commands.
+
+```pwsh
+$env:AWS_ACCESS_KEY_ID = 'your_access_key'
+$env:AWS_SECRET_ACCESS_KEY = 'your_secret_key'
+$env:AWS_REGION = 'us-west-2'   # Put whichever AWS region that you'd like, that the Bedrock service supports.
+```
+
+
+## Get Started
+
+Once your AWS credentials are set up, you can run Aider with the `--model` command line switch, specifying the Bedrock model you want to use:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+aider --model bedrock/anthropic.claude-3-5-sonnet-20240620-v1:0
+```
+
+Sometimes it seems to help if you prefix the model name with "us.":
+
+```bash
+aider --model bedrock/us.anthropic.claude-3-5-sonnet-20240620-v1:0
+```
+
+
+## Available Models
+
+To see some models available via Bedrock, run:
+
+```bash
+aider --list-models bedrock/
+```
+
+Make sure you have access to these models in your AWS account before attempting to use them with Aider.
+
+## Install boto3
+You may need to install the `boto3` package.
+
+```bash
+# If you installed with aider-install or `uv tool`
+uv tool run --from aider-chat pip install boto3
+
+# Or with pipx...
+pipx inject aider-chat boto3
+
+# Or with pip
+pip install -U boto3
+```
+
+# More info
+
+For more information on Amazon Bedrock and its models, refer to the [official AWS documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html).
+
+Also, see the 
+[litellm docs on Bedrock](https://litellm.vercel.app/docs/providers/bedrock).

cecli/website/docs/llms/cohere.md

@@ -0,0 +1,34 @@
+---
+parent: Connecting to LLMs
+nav_order: 500
+---
+
+# Cohere
+
+Cohere offers *free* API access to their models.
+Their Command-R+ model works well with aider
+as a *very basic* coding assistant.
+You'll need a [Cohere API key](https://dashboard.cohere.com/welcome/login).
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```
+export COHERE_API_KEY=<key> # Mac/Linux
+setx   COHERE_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and Cohere on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+aider --model command-r-plus-08-2024
+
+# List models available from Cohere
+aider --list-models cohere_chat/
+```

cecli/website/docs/llms/deepseek.md

@@ -0,0 +1,32 @@
+---
+parent: Connecting to LLMs
+nav_order: 500
+---
+
+# DeepSeek
+
+Aider can connect to the DeepSeek.com API.
+To work with DeepSeek's models, you need to set the `DEEPSEEK_API_KEY` environment variable with your [DeepSeek API key](https://platform.deepseek.com/api_keys).  
+The DeepSeek Chat V3 model has a top score on aider's code editing benchmark.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```
+export DEEPSEEK_API_KEY=<key> # Mac/Linux
+setx   DEEPSEEK_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and DeepSeek on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+# Use DeepSeek Chat v3
+aider --model deepseek/deepseek-chat
+```
+

cecli/website/docs/llms/gemini.md

@@ -0,0 +1,49 @@
+---
+parent: Connecting to LLMs
+nav_order: 300
+---
+
+# Gemini
+
+You'll need a [Gemini API key](https://aistudio.google.com/app/u/2/apikey).
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```bash
+export GEMINI_API_KEY=<key> # Mac/Linux
+setx   GEMINI_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and Gemini on your codebase:
+
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+# You can run the Gemini 2.5 Pro model with this shortcut:
+aider --model gemini
+
+# You can run the Gemini 2.5 Pro Exp for free, with usage limits:
+aider --model gemini-exp
+
+# List models available from Gemini
+aider --list-models gemini/
+```
+
+You may need to install the `google-generativeai` package. 
+
+```bash
+# If you installed with aider-install or `uv tool`
+uv tool run --from aider-chat pip install google-generativeai
+
+# Or with pipx...
+pipx inject aider-chat google-generativeai
+
+# Or with pip
+pip install -U google-generativeai
+```

cecli/website/docs/llms/github.md

@@ -0,0 +1,111 @@
+---
+parent: Connecting to LLMs
+nav_order: 510
+---
+
+# GitHub Copilot
+
+Aider can connect to GitHub Copilot’s LLMs because Copilot exposes a standard **OpenAI-style**
+endpoint at:
+
+```
+https://api.githubcopilot.com
+```
+
+First, install aider:
+
+{% include install.md %}
+
+---
+
+## Configure your environment
+
+```bash
+# macOS/Linux
+export OPENAI_API_BASE=https://api.githubcopilot.com
+export OPENAI_API_KEY=<oauth_token>
+
+# Windows (PowerShell)
+setx OPENAI_API_BASE https://api.githubcopilot.com
+setx OPENAI_API_KEY  <oauth_token>
+# …restart the shell after setx commands
+```
+
+---
+
+### Where do I get the token?
+The easiest path is to sign in to Copilot from any JetBrains IDE (PyCharm, GoLand, etc).
+After you authenticate a file appears:
+
+```
+~/.config/github-copilot/apps.json
+```
+
+On Windows the config can be found in:
+
+```
+~\AppData\Local\github-copilot\apps.json
+```
+
+Copy the `oauth_token` value – that string is your `OPENAI_API_KEY`.
+
+*Note:* tokens created by the Neovim **copilot.lua** plugin (old `hosts.json`) sometimes lack the
+needed scopes. If you see “access to this endpoint is forbidden”, regenerate the token with a
+JetBrains IDE.
+
+---
+
+## Discover available models
+
+Copilot hosts many models (OpenAI, Anthropic, Google, etc).  
+List the models your subscription allows with:
+
+```bash
+curl -s https://api.githubcopilot.com/models \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -H "Content-Type: application/json" \
+  -H "Copilot-Integration-Id: vscode-chat" | jq -r '.data[].id'
+```
+
+Each returned ID can be used with aider by **prefixing it with `openai/`**:
+
+```bash
+aider --model openai/gpt-4o
+# or
+aider --model openai/claude-3.7-sonnet-thought
+```
+
+---
+
+## Quick start
+
+```bash
+# change into your project
+cd /to/your/project
+
+# talk to Copilot
+aider --model openai/gpt-4o
+```
+
+---
+
+## Optional config file (`~/.aider.conf.yml`)
+
+```yaml
+openai-api-base: https://api.githubcopilot.com
+openai-api-key:  "<oauth_token>"
+model:           openai/gpt-4o
+weak-model:      openai/gpt-4o-mini
+show-model-warnings: false
+```
+
+---
+
+## FAQ
+
+* Calls made through aider are billed through your Copilot subscription  
+  (aider will still print *estimated* costs).
+* The Copilot docs explicitly allow third-party “agents” that hit this API – aider is playing by
+  the rules.
+* Aider talks directly to the REST endpoint—no web-UI scraping or browser automation.
+

cecli/website/docs/llms/groq.md

@@ -0,0 +1,36 @@
+---
+parent: Connecting to LLMs
+nav_order: 400
+---
+
+# GROQ
+
+Groq currently offers *free* API access to the models they host.
+The Llama 3 70B model works
+well with aider and is comparable to GPT-3.5 in code editing performance.
+You'll need a [Groq API key](https://console.groq.com/keys).
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```
+export GROQ_API_KEY=<key> # Mac/Linux
+setx   GROQ_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and Groq on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+aider --model groq/llama3-70b-8192
+
+# List models available from Groq
+aider --list-models groq/
+```
+
+

cecli/website/docs/llms/lm-studio.md

@@ -0,0 +1,39 @@
+---
+parent: Connecting to LLMs
+nav_order: 400
+---
+
+# LM Studio
+
+Aider can connect to models served by LM Studio.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API key and endpoint:
+
+```
+# Must set a value here even if its a dummy value
+export LM_STUDIO_API_KEY=dummy-api-key # Mac/Linux
+setx   LM_STUDIO_API_KEY dummy-api-key # Windows, restart shell after setx
+
+# LM Studio default server URL is http://localhost:1234/v1
+export LM_STUDIO_API_BASE=http://localhost:1234/v1 # Mac/Linux
+setx   LM_STUDIO_API_BASE http://localhost:1234/v1 # Windows, restart shell after setx
+```
+
+**Note:** Even though LM Studio doesn't require an API Key out of the box the `LM_STUDIO_API_KEY` must have a dummy value like `dummy-api-key` set or the client request will fail trying to send an empty `Bearer` token.
+
+Start working with aider and LM Studio on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+aider --model lm_studio/<your-model-name>
+```
+
+See the [model warnings](warnings.html)
+section for information on warnings which will occur
+when working with models that aider is not familiar with.

cecli/website/docs/llms/ollama.md

@@ -0,0 +1,75 @@
+---
+parent: Connecting to LLMs
+nav_order: 500
+---
+
+# Ollama
+
+Aider can connect to local Ollama models.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your Ollama API endpoint (usually the default):
+
+```bash
+export OLLAMA_API_BASE=http://127.0.0.1:11434 # Mac/Linux
+setx   OLLAMA_API_BASE http://127.0.0.1:11434 # Windows, restart shell after setx
+```
+
+Start working with aider and Ollama on your codebase:
+
+```
+# Pull the model
+ollama pull <model>
+
+# Start your ollama server, increasing the context window to 8k tokens
+OLLAMA_CONTEXT_LENGTH=8192 ollama serve
+
+# In another terminal window, change directory into your codebase
+cd /to/your/project
+
+aider --model ollama_chat/<model>
+```
+
+{: .note }
+Using `ollama_chat/` is recommended over `ollama/`.
+
+
+See the [model warnings](warnings.html)
+section for information on warnings which will occur
+when working with models that aider is not familiar with.
+
+## API Key
+
+If you are using an ollama that requires an API key you can set `OLLAMA_API_KEY`:
+
+```
+export OLLAMA_API_KEY=<api-key> # Mac/Linux
+setx   OLLAMA_API_KEY <api-key> # Windows, restart shell after setx
+```
+
+## Setting the context window size
+
+[Ollama uses a 2k context window by default](https://github.com/ollama/ollama/blob/main/docs/faq.md#how-can-i-specify-the-context-window-size),
+which is very small for working with aider.
+It also **silently** discards context that exceeds the window. 
+This is especially dangerous because many users don't even realize that most of their data
+is being discarded by Ollama.
+ 
+By default, aider sets Ollama's context window 
+to be large enough for each request you send plus 8k tokens for the reply.
+This ensures data isn't silently discarded by Ollama.
+
+If you'd like you can configure a fixed sized context window instead
+with an
+[`.aider.model.settings.yml` file](https://aider.chat/docs/config/adv-model-settings.html#model-settings)
+like this:
+
+```
+- name: ollama/qwen2.5-coder:32b-instruct-fp16
+  extra_params:
+    num_ctx: 65536
+```
+

cecli/website/docs/llms/openai-compat.md

@@ -0,0 +1,39 @@
+---
+parent: Connecting to LLMs
+nav_order: 500
+---
+
+# OpenAI compatible APIs
+
+Aider can connect to any LLM which is accessible via an OpenAI compatible API endpoint.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API key and endpoint:
+
+```
+# Mac/Linux:
+export OPENAI_API_BASE=<endpoint>
+export OPENAI_API_KEY=<key>
+
+# Windows:
+setx OPENAI_API_BASE <endpoint>
+setx OPENAI_API_KEY <key>
+# ... restart shell after setx commands
+```
+
+Start working with aider and your OpenAI compatible API on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+# Prefix the model name with openai/
+aider --model openai/<model-name>
+```
+
+See the [model warnings](warnings.html)
+section for information on warnings which will occur
+when working with models that aider is not familiar with.