CLI Mistral

La CLI mistral crée des projets, les exécute localement, déploie des apps et workflows et gère les ressources Studio depuis votre terminal.

Installer

curl -fsSL https://mistral.ai/cli/install.sh | bash
mistral --version
mistral --help

curl -fsSL https://mistral.ai/cli/install.sh | bash
mistral --version
mistral --help

Le programme d'installation choisit le binaire de votre plateforme, vérifie son checksum et l'installe dans ~/.mistral/bin/mistral. Suivez ses instructions PATH si la commande reste introuvable. macOS et Linux sont pris en charge sur x64 et arm64.

Les apps nécessitent Bun. Si Bun est absent, son installation est proposée. Si vous refusez ou si aucun terminal n'est disponible, la commande à exécuter est affichée. MISTRAL_INSTALL_BUN=1 installe Bun sans confirmation ; MISTRAL_INSTALL_BUN=0 ignore cette étape.

Pour choisir une version publiée X.Y.Z, définissez MISTRAL_VERSION. MISTRAL_INSTALL_DIR modifie le répertoire d'installation. Consultez les versions de la CLI.

Mettre à jour

mistral upgrade
mistral --version

mistral upgrade
mistral --version

mistral upgrade --dry-run affiche la commande d'installation prévue. Vous pouvez aussi relancer l'installateur avec MISTRAL_VERSION. Régénérez les complétions statiques après la mise à jour.

Complétions du shell

La CLI génère les complétions Bash, Zsh et Fish. Créer un fichier ne suffit pas à le charger dans le shell actuel.

Pour Bash, ajoutez à ~/.bashrc :

command -v mistral >/dev/null && eval "$(mistral --completions bash)"

command -v mistral >/dev/null && eval "$(mistral --completions bash)"

Pour Zsh :

mkdir -p ~/.zsh/completions
mistral --completions zsh > ~/.zsh/completions/_mistral

mkdir -p ~/.zsh/completions
mistral --completions zsh > ~/.zsh/completions/_mistral

Ajoutez le répertoire à fpath avant compinit dans ~/.zshrc :

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit

Pour Fish :

mkdir -p ~/.config/fish/completions
mistral --completions fish > ~/.config/fish/completions/mistral.fish

mkdir -p ~/.config/fish/completions
mistral --completions fish > ~/.config/fish/completions/mistral.fish

Ouvrez un nouveau shell. Après une mise à jour, régénérez les complétions Zsh ou Fish. Si Zsh ne complète toujours pas les nouvelles commandes, vérifiez que fpath inclut le répertoire généré et que compinit s'exécute ensuite.

Commandes

Commande	Utilisation
`mistral init`	Créer une app ou un workflow à partir d'un preset ou de capacités sélectionnées.
`mistral dev`	Exécuter les composants en développement local.
`mistral deploy`	Déployer le projet dans Studio.
`mistral workflows`	Créer des projets de workflows.
`mistral apps`	Lister les apps, gérer les capacités, consulter les logs et publier les apps déployées.
`mistral evals`	Exécuter, optimiser et gérer les évaluations hors ligne.
`mistral observability`	Rechercher et consulter les traces, spans et logs.
`mistral login`, `logout`, `whoami`, `context`	Se connecter, se déconnecter et choisir l'organisation et l'espace de travail.
`mistral upgrade`	Mettre la CLI à jour.

mistral --help affiche les commandes de votre version. mistral COMMAND --help détaille leurs options.

Configuration

Le répertoire de configuration est $MISTRAL_CONFIG_DIR si défini, sinon $XDG_CONFIG_HOME/mistral, sinon ~/.config/mistral. Gardez les identifiants privés. Consultez Télémétrie.

Suivez le Guide de démarrage CLI ou créez votre première app.