# Mistral


# Mistral (SDK)

{{< callout type="note" title="SDK addon — not an interactive CLI" >}}
The `ai-mistral` addon installs the **mistralai Python SDK**, not an interactive coding CLI. It is intended for projects that call the Mistral API programmatically. For an interactive coding experience, use [Claude](./ai-claude.md), [Gemini](./ai-gemini.md), [OpenAI Codex](./ai-openai.md), or [Copilot](./ai-copilot.md) instead.
{{< /callout >}}

[Mistral AI](https://mistral.ai) provides large language models via Python SDK.

## Setup

```toml
[ai]
model_providers = ["mistral"]

[addons.ai-mistral.tools]
mistral = {}
```

`mistral` is retained as a legacy harness value for old configs, but it is not
a current interactive CLI harness. Use the addon directly for SDK installs.
Run `aibox apply`. Inside the container the `mistralai` Python SDK is available
for scripting:

```python
from mistralai import Mistral
client = Mistral(api_key="...")
```

## API Key

```toml
[container.environment]
MISTRAL_API_KEY = "..."
```

## MCP Integration

aibox generates `.mcp.json` (the Claude Code MCP format) on `aibox apply` when a compatible harness is enabled, merging processkit built-in servers in processkit mode, team servers from `aibox.toml [ai.mcp]`, and personal servers from `.aibox-local.toml [mcp]`. A custom Mistral SDK-based tool you build can read MCP server registrations from this file.

`.mcp.json` is **gitignored** — it is regenerated on every `aibox apply` and must not be committed.

## Installation

The Mistral AI SDK is installed via pip (`pip install --no-cache-dir mistralai`).


---
Source: https://projectious-work.github.io/aibox/v0.x/v0.34.1/docs/providers/ai-mistral/index.md