Home
Studio

Guide de démarrage : construire votre première app

Créez une app full-stack avec le preset app, exécutez-la localement, puis déployez-la dans Studio. Aucune expérience préalable de la CLI Mistral n'est nécessaire.

1. Installer les outils

1. Installer les outils

Installez d'abord les outils suivants :

  • Git.
  • uv, pour l'API Python et le worker.
  • Docker, pour la base de données locale.

Il vous faut aussi un compte GitHub pour héberger le dépôt à partir duquel vous déployez.

Installez la CLI Mistral :

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

Acceptez la proposition du programme d'installation d'ajouter ~/.mistral/bin à votre PATH. La modification ne s'applique qu'aux nouveaux shells : ouvrez un nouveau terminal ou exécutez source sur le profil indiqué, puis vérifiez la version :

source ~/.zshrc   # zsh; bash: ~/.bashrc or ~/.bash_profile, fish: ~/.config/fish/config.fish
mistral --version

Les apps ont besoin de Bun. S'il est absent, le programme d'installation propose de l'installer. Si vous refusez ou si vous lancez l'installation sans terminal, suivez la commande Bun affichée. Pour installer Bun sans confirmation, définissez MISTRAL_INSTALL_BUN=1 pour le programme d'installation. Pour en savoir plus, consultez Installer la CLI.

2. Se connecter

2. Se connecter

mistral login
mistral context show

mistral login vous connecte via votre navigateur. mistral context show affiche l'organisation et l'espace de travail actifs. Pour en changer, exécutez mistral context set. Les étapes suivantes utilisent cette connexion pour exécuter, déployer et publier l'app. Sans elle, mistral deploy peut utiliser une clé API, comme l'explique Déployer avec une clé API.

3. Créer l'app

3. Créer l'app

mistral init my-app --preset app
cd my-app

Le preset app crée un frontend web dans apps/web, une API Python dans apps/api, un worker de workflows dans apps/worker et une base de données Postgres. La CLI ajoute aussi la capacité d'espace de travail partagé, core, et commite le squelette dans un nouveau dépôt Git.

Ouvrez le fichier .env généré et définissez MISTRAL_API_KEY avec votre clé API. Le worker l'utilise pour se connecter à Mistral. Laissez les valeurs de base de données telles que init les a écrites. Git ignore .env : votre clé reste hors du dépôt.

Pour partir d'autres composants, consultez Sélectionner des capacités.

4. Exécuter localement

4. Exécuter localement

Avertissement

Démarrez Docker avant de lancer mistral dev. Sans Docker, l'app démarre sans sa base de données.

mistral dev

La CLI démarre la base de données, l'API, le worker et l'app web derrière une passerelle locale, puis affiche leur état et leurs logs. Ouvrez l'URL affichée, par exemple http://my-app.apps.localhost:8080. Si le worker s'arrête avec Authentication failed, vérifiez MISTRAL_API_KEY dans .env.

Laissez la commande active pendant vos modifications. Pour l'arrêter, appuyez sur Ctrl-C. Pour l'accès à l'API et le dépannage, consultez Développement local.

5. Déployer

5. Déployer

i
Information

mistral deploy apparaît une fois que vous êtes connecté avec mistral login. Le plan de votre organisation doit inclure Apps : avec le plan Free, ou Pro et Team sans paiement à l'usage, vous voyez les commandes de déploiement mais vous ne pouvez pas créer d'app. Consultez les limites des plans.

Créez un dépôt vide dans votre compte ou votre organisation GitHub. Ajoutez-le ensuite comme remote origin, poussez l'app et déployez :

git remote add origin https://github.com/YOUR-ORG/my-app.git
git push -u origin HEAD
mistral deploy

Remplacez YOUR-ORG par le propriétaire du dépôt. mistral deploy construit le commit poussé : commitez et poussez chaque modification avant de déployer. Le répertoire de travail doit être propre.

La plateforme clone le dépôt via votre connexion GitHub. Si votre compte Mistral n'est pas connecté à GitHub, ou si l'app GitHub de Mistral ne voit pas le dépôt, la CLI s'arrête avant de créer quoi que ce soit et propose d'ouvrir la page GitHub qui règle le problème.

Sélectionnez votre organisation et votre espace de travail quand la CLI vous le demande. Elle affiche la destination, construit l'app et affiche son URL à la fin du déploiement. Le premier déploiement crée aussi la base de données et déploie le worker en tant que déploiement de workflows géré : il prend donc quelques minutes de plus que les suivants.

Le premier déploiement enregistre la cible de déploiement dans mistral.json. Acceptez la proposition de la CLI de commiter et de pousser ce fichier, ou commitez-le vous-même avant le prochain déploiement. La CLI n'envoie pas .env : définissez les valeurs dont l'app a besoin, comme MISTRAL_API_KEY, dans l'onglet Secrets de l'app dans Studio, sur chaque module concerné. Pour en savoir plus, consultez Déployer.

Étapes suivantes

Étapes suivantes