chatmcp-cli 0.1.0__py3-none-any.whl

aider/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).

aider/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/
+```

aider/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
+```
+

aider/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
+```

aider/website/docs/llms/github.md

@@ -0,0 +1,105 @@
+---
+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
+```
+
+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 or the VS Code Copilot extension.
+
+---
+
+## 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.
+

aider/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/
+```
+
+

aider/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.

aider/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
+```
+

aider/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.

aider/website/docs/llms/openai.md

@@ -0,0 +1,58 @@
+---
+parent: Connecting to LLMs
+nav_order: 100
+---
+
+# OpenAI
+
+To work with OpenAI's models, you need to provide your
+[OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-secret-api-key)
+either in the `OPENAI_API_KEY` environment variable or
+via the `--api-key openai=<key>` command line switch.
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```
+export OPENAI_API_KEY=<key> # Mac/Linux
+setx   OPENAI_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and OpenAI on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+# o3-mini
+aider --model o3-mini
+
+# o1-mini
+aider --model o1-mini
+
+# GPT-4o
+aider --model gpt-4o
+
+# List models available from OpenAI
+aider --list-models openai/
+```
+
+You can use `aider --model <model-name>` to use any other OpenAI model.
+For example, if you want to use a specific version of GPT-4 Turbo
+you could do `aider --model gpt-4-0125-preview`.
+
+## Reasoning models from other providers
+
+Many of OpenAI's 
+"reasoning" models have restrictions on streaming and setting the temperature parameter.
+Some also support different levels of "reasoning effort".
+Aider is configured to work properly with these models
+when served through major provider APIs and
+has a `--reasoning-effort` setting.
+
+You may need to [configure reasoning model settings](/docs/config/reasoning.html)
+if you are using them through another provider
+and see errors related to temperature or system prompt.

aider/website/docs/llms/openrouter.md

@@ -0,0 +1,78 @@
+---
+parent: Connecting to LLMs
+nav_order: 500
+---
+
+# OpenRouter
+
+Aider can connect to [models provided by OpenRouter](https://openrouter.ai/models?o=top-weekly):
+You'll need an [OpenRouter API key](https://openrouter.ai/keys).
+
+First, install aider:
+
+{% include install.md %}
+
+Then configure your API keys:
+
+```
+export OPENROUTER_API_KEY=<key> # Mac/Linux
+setx   OPENROUTER_API_KEY <key> # Windows, restart shell after setx
+```
+
+Start working with aider and OpenRouter on your codebase:
+
+```bash
+# Change directory into your codebase
+cd /to/your/project
+
+# Or any other open router model
+aider --model openrouter/<provider>/<model>
+
+# List models available from OpenRouter
+aider --list-models openrouter/
+```
+
+In particular, many aider users access Sonnet via OpenRouter:
+
+{: .tip }
+If you get errors, check your
+[OpenRouter privacy settings](https://openrouter.ai/settings/privacy).
+Be sure to "enable providers that may train on inputs"
+to allow use of all models.
+
+## Controlling provider selection
+
+OpenRouter often has multiple providers serving each model.
+You can control which OpenRouter providers are used for your requests in two ways:
+
+1. By "ignoring" certain providers in your
+[OpenRouter account settings](https://openrouter.ai/settings/preferences).
+This disables those named providers across all the models that you access via OpenRouter.
+
+2. By configuring "provider routing" in a `.aider.model.settings.yml` file.
+
+Place that file in your home directory or the root of your git project, with
+entries like this:
+
+```yaml
+- name: openrouter/anthropic/claude-3.7-sonnet
+  extra_params:
+    extra_body:
+      provider:
+        # Only use these providers, in this order
+        order: ["Anthropic", "Together"]
+        # Don't fall back to other providers
+        allow_fallbacks: false
+        # Skip providers that may train on inputs
+        data_collection: "deny"
+        # Only use providers supporting all parameters
+        require_parameters: true
+```
+
+See [OpenRouter's provider routing docs](https://openrouter.ai/docs/provider-routing) for full details on these settings.
+
+See [Advanced model settings](https://aider.chat/docs/config/adv-model-settings.html#model-settings)
+for more details about model settings files. 
+
+
+