mistral-vibe

library2.7.5pypypiunverified

Mistral Vibe is a minimal command-line interface (CLI) coding agent developed by Mistral AI, currently at version 2.7.5. It provides a conversational interface to interact with a codebase, allowing developers to use natural language for tasks like exploring, modifying, and interacting with projects through a powerful set of integrated tools. The library maintains an active development pace with frequent updates, often multiple releases within a month, focusing on new features, performance improvements, and bug fixes.

llm-agents

pip install mistral-vibe

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · MISTRAL-VIBE

mistral-vibe

llm-agentspythonv2.7.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

To quickly start using Mistral Vibe, navigate to your project's root directory and run the `vibe` command. Ensure your Mistral API key is set as an environment variable or configured via `vibe --setup`. The first run will set up configuration and prompt for the API key if missing.

export MISTRAL_API_KEY="$MISTRAL_API_KEY" cd /path/to/your/project vibe # Interact with the agent, e.g., type: > Can you find all instances of 'TODO'?

vibe --version

Debug

Known issues

breakingWith Mistral Vibe 2.0 (released January 2026), the underlying Devstral 2 model shifted from free testing to a paid offering, bundled with Mistral's Le Chat plans. Direct API key usage might incur charges, and access might require specific plans.

fix

Review Mistral AI's pricing and plans, and ensure your API key is associated with an active, paid plan if using cloud models.

affects: >=2.0.0

gotchaA Mistral API key is mandatory for most operations and must be configured via `vibe --setup`, the `MISTRAL_API_KEY` environment variable, or a `.env` file in `~/.vibe/`. Without it, Vibe will prompt for the key or fail.

fix

Set your API key using `export MISTRAL_API_KEY="your_mistral_api_key"` in your shell, create a `.env` file in `~/.vibe/`, or run `vibe --setup`.

affects: All versions

gotchaWhile Mistral Vibe works on Windows, it officially supports and targets UNIX environments (Linux and macOS). Users on Windows might encounter specific issues or limitations.

fix

For Windows users, consider using Windows Subsystem for Linux (WSL) for a more officially supported experience, or be prepared for potential platform-specific issues.

affects: All versions

gotchaUsers may encounter 'Ratelimit exceeded' errors or 'LLM backend error' during rapid sequential requests to the Mistral API, leading to halted execution. The CLI might not automatically retry or regulate requests effectively in all scenarios.

fix

Reduce the frequency of your requests, wait a short period before retrying, or check if features like `--auto-approve` are causing too many rapid tool calls without sufficient delays.

affects: All versions

gotchaMistral Vibe explicitly requires Python 3.12 or newer. Using older Python versions will lead to installation or runtime errors.

fix

Upgrade your Python installation to version 3.12 or newer, or switch to a virtual environment configured with Python 3.12+.

affects: All versions

Errors

Common errors & fixes

Error: API error from mistral (model: mistral-vibe-cli-latest): LLM backend error...

The Mistral API key is either not provided, invalid, or there's a transient issue with the Mistral backend.

fix

Ensure `MISTRAL_API_KEY` is correctly set as an environment variable (e.g., `export MISTRAL_API_KEY="YOUR_KEY"`) or configured via `vibe --setup`. Verify your API key's validity on the Mistral AI console.

Error: API error from mistral (model: mistral-vibe-cli-latest): Ratelimit exceeded.

Too many rapid requests were sent to the Mistral API within a short period, hitting rate limits.

fix

Reduce the frequency of your requests, wait a short period before retrying, or check if `--auto-approve` is causing too many rapid tool calls.

Requires-Python-Error: mistral-vibe requires Python >=3.12...

The Python environment being used is older than version 3.12.

fix

Upgrade your Python installation to version 3.12 or newer, or switch to a virtual environment configured with Python 3.12+.

Command 'vibe' not found

The `mistral-vibe` package's executable is not in your system's PATH, or the installation failed.

fix

Ensure `pip install mistral-vibe` completed successfully. If using a virtual environment, ensure it's activated. On Linux/macOS, consider the `curl` installer or `uv tool install mistral-vibe` to ensure the executable is correctly placed and linked.

Upgrade

Version history

2.7.5latest on PyPI · released Apr 14, 2026

Audit

Dependencies

agent-client-protocolrequiredCore communication protocol for agent interactions.

textualrequiredPowers the rich terminal user interface of the CLI.

mistralairequiredOfficial Mistral AI SDK for interacting with Mistral models.

python-dotenvrequiredUsed for loading API keys from .env files.

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/mistralai/mistral-vibe#readme ↗

packagehttps://pypi.org/project/mistral-vibe/ ↗

docshttps://github.com/mistralai/mistral-vibe#readme ↗