Utiliser Mandri depuis le terminal

La commande mandri permet de configurer des fournisseurs et de lancer un agent dans le terminal. Le paquet Python installe la CLI et le daemon local. L’application graphique se télécharge séparément.

Installer la CLI

Installez uv, puis exécutez :

uv tool install --python 3.13 mandri

uv sélectionne Python 3.13 pour cette installation. Codex est inclus avec Mandri. Les autres outils, comme Pi, nécessitent leur propre installation.

Connecter un fournisseur de modèles

Choisissez le parcours correspondant au compte ou au serveur que vous utilisez :

Le nom du fournisseur identifie votre connexion. Une référence de modèle prend la forme <provider-name>/<model-id>. Recopiez l’identifiant exact du catalogue, y compris les barres obliques qu’il contient.

Lancer depuis le dossier de votre projet

Ouvrez un terminal dans le dossier sur lequel l’agent doit travailler. Une fois votre fournisseur configuré, remplacez les deux valeurs entre chevrons :

mandri run --model "<provider-name>/<model-id>" codex

Mandri démarre son daemon local si nécessaire et ouvre Codex dans ce dossier. Saisissez votre demande dans le terminal et répondez aux demandes d’autorisation. Vérifiez les modifications avant de les conserver.

Pour choisir un autre dossier, placez --cwd avant codex :

mandri run --model "<provider-name>/<model-id>" --cwd "/path/to/project" codex

Ces commandes utilisent vos réglages par défaut d’exécution et de confidentialité. Pour choisir explicitement l’exécution sur l’hôte sans pseudonymisation, ajoutez --execution-backend host --privacy-mode none avant codex. Consultez les modes surrogate et Docker pour les autres réglages et leurs prérequis de plateforme.

Vérifier une connexion

mandri provider list
mandri provider verify <provider-name>
mandri provider models <provider-name>

La vérification contrôle l’accès au fournisseur. Elle ne lance pas de tâche et ne prouve pas que chaque modèle du catalogue peut utiliser les outils correctement.

Pour utiliser l’interface graphique, consultez Lancer une première tâche dans l’application.