Skip to content
pi-mistral-native

Welcome

pi-mistral-native — Native Mistral AI provider for the pi coding agent. A pi symbol built from blue blocks on an ink background.

A Mistral-specific, optimized integration for the pi coding agent — not just chat. pi-mistral-native registers the native mistral-native provider and exposes Mistral's full feature surface as first-class pi capabilities.

Quickstart

Install the package, log in once, and pick a model:

pi install npm:pi-mistral-native
pi /login mistral-native

The guided login prompts for an API key and the API region — and that's it: the provider is registered, the model catalog refreshes from Mistral's live model list, and the knowledge, OCR and connector tools are available in every session.

Where to go next

Get startedInstall, log in, pick a region, and chat — one guided path.
How-to guidesGet a task done: set a key, change a setting, use a region, query documents.
ReferenceLook it up: configuration keys, commands, tools, environment variables.
ConceptsUnderstand why: configuration layers, regions, tools, streaming.

What you can do

Everything below works inside your normal pi session — no separate client, no context switching.

Chat with Mistral models — including reasoningPick any mistral-native/… model and chat as usual: thinking streams into proper thinking blocks, tool calls execute, usage and cost are shown.Use Mistral connectors as toolsOutlook, SharePoint, Notion, Google Drive, … — grant access once; the connector’s MCP tools become ordinary pi tools your agent can call.Run tools mid-chatImage generation server-side with one setting; web search and code execution as dedicated tools — no client-side glue.Extract text from images and PDFs (OCR)Point the agent at a screenshot, scan or PDF and get per-page markdown back with mistral_ocr.Search your own documents (RAG)Upload a file once, then ask questions about it — answers come back with citations linking to the source passages.An always-current model list with estimated pricesNew and retired Mistral models show up (or disappear) without a package update, each priced from a sourced rate card — costs are catalog estimates, marked as such.Check and shape contentModerations (policy flags with scores), embeddings, and classification against your fine-tuned models — all as tools.Route through the EU or US regionData-residency routing with one key (or one prompt during /login).Configure everything without leaving piThe /mistral command family shows every effective setting, writes user-scope keys by default (project-scope with --project) and checks the live connection.

Install

The package installs as a pi package; Node.js ≥ 22 is required. See the development docs for building from a local checkout.