Mistral

Mistral (SDK)#

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, Gemini, OpenAI Codex, or Copilot instead.

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