{"id":7411,"library":"mistral-vibe","title":"Mistral Vibe CLI Agent","description":"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.","status":"active","version":"2.7.5","language":"en","source_language":"en","source_url":"https://github.com/mistralai/mistral-vibe","tags":["AI","CLI","agent","mistral","developer-tool","coding-assistant","LLM"],"install":[{"cmd":"pip install mistral-vibe","lang":"bash","label":"Using pip"},{"cmd":"uv tool install mistral-vibe","lang":"bash","label":"Using uv (requires uv installed)"},{"cmd":"curl -LsSf https://mistral.ai/vibe/install.sh | bash","lang":"bash","label":"Recommended for Linux/macOS"}],"dependencies":[{"reason":"Core communication protocol for agent interactions.","package":"agent-client-protocol"},{"reason":"Powers the rich terminal user interface of the CLI.","package":"textual"},{"reason":"Official Mistral AI SDK for interacting with Mistral models.","package":"mistralai"},{"reason":"Used for loading API keys from .env files.","package":"python-dotenv"}],"imports":[],"quickstart":{"code":"export MISTRAL_API_KEY=\"$MISTRAL_API_KEY\"\ncd /path/to/your/project\nvibe\n# Interact with the agent, e.g., type: > Can you find all instances of 'TODO'?","lang":"bash","description":"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."},"warnings":[{"fix":"Review Mistral AI's pricing and plans, and ensure your API key is associated with an active, paid plan if using cloud models.","message":"With 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.","severity":"breaking","affected_versions":">=2.0.0"},{"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`.","message":"A 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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"While Mistral Vibe works on Windows, it officially supports and targets UNIX environments (Linux and macOS). Users on Windows might encounter specific issues or limitations.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"Users 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.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Upgrade your Python installation to version 3.12 or newer, or switch to a virtual environment configured with Python 3.12+.","message":"Mistral Vibe explicitly requires Python 3.12 or newer. Using older Python versions will lead to installation or runtime errors.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"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.","cause":"The Mistral API key is either not provided, invalid, or there's a transient issue with the Mistral backend.","error":"Error: API error from mistral (model: mistral-vibe-cli-latest): LLM backend error..."},{"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.","cause":"Too many rapid requests were sent to the Mistral API within a short period, hitting rate limits.","error":"Error: API error from mistral (model: mistral-vibe-cli-latest): Ratelimit exceeded."},{"fix":"Upgrade your Python installation to version 3.12 or newer, or switch to a virtual environment configured with Python 3.12+.","cause":"The Python environment being used is older than version 3.12.","error":"Requires-Python-Error: mistral-vibe requires Python >=3.12..."},{"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.","cause":"The `mistral-vibe` package's executable is not in your system's PATH, or the installation failed.","error":"Command 'vibe' not found"}]}