Skip to main content

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

[ai.harness.mistral]
enabled = true
install = true

Run aibox apply. Inside the container the mistralai Python SDK is available for scripting:

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

API Key

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

MCP Integration

aibox generates .mcp.json (the Claude Code MCP format) on aibox apply, merging processkit built-in servers, 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).