Install and setup | Mistral Docs

Install the Vibe CLI, run vibe in your project, and complete the setup prompt.

On a different interface? This page covers the CLI specifically. If you'd rather work inside your editor or against a remote repo, jump to VS Code extension or Vibe Code Web. See Choose CLI, VS Code, or web sessions for a side-by-side comparison.

Before you install the CLI, make sure you have:

macOS, Linux, or Windows.
Python 3.12 or later for manual installation.
(Optional) a Mistral account to use Mistral-hosted models. The CLI also works fully offline with local models, or against any compatible API key you provide.

If you choose to use Mistral-hosted models, sign in with your Mistral account during setup. For non-Mistral providers or automation, create an API key from Code > Vibe CLI. The same key works in Free mode, with a paid plan, or with pay-as-you-go enabled.

Use the one-line installer:

The installer:

Checks whether uv is installed and installs it if needed.
Installs or upgrades mistral-vibe with uv tool install or uv tool upgrade.
Makes the vibe and vibe-acp commands available, provided your PATH is configured.

If the installer reports that vibe is not on your PATH, add the displayed directory to your shell profile and restart your terminal.

Open a terminal in your project root and run:

On first launch, Vibe:

Creates a default configuration file at ~/.vibe/config.toml if it does not already exist.
Walks you through a setup wizard to register your API key.

The setup wizard asks you to sign in or provide an API key:

Sign in with a Mistral account: use your Mistral plan. Vibe Code is included, with usage and rate limits based on your plan and pay-as-you-go settings.
Use a custom API key: generate a key from Code > Vibe CLI or use a key from another compatible provider.

Paste your API key when prompted. The wizard saves it for future sessions in the Vibe home directory. You can also set MISTRAL_API_KEY in your shell environment if you prefer not to use the interactive prompt.

You can rerun the setup wizard at any time using vibe --setup.

Your setup is ready when:

vibe --version returns a version.
vibe opens the interactive terminal interface from your project root.
Vibe accepts a prompt without asking for an API key again.

Try a small first prompt:

If the CLI fails to start or behaves unexpectedly after editing the config, move the file aside and restart Vibe. A fresh ~/.vibe/config.toml is generated on the next launch: