Gaadji
Documentation
← Mon dashboard

Tutoriel : ma première calculatrice avec Gaadji

Ce tutoriel te montre comment générer un projet Python complet (calculatrice + tests pytest) en utilisant l'extension VSCode Gaadji multi-agent. Durée : 10 minutes.

Niveau : débutant ~10 minutes Coût estimé : $0,005-$0,015
Sommaire
  1. Prérequis
  2. Installer l'extension VSCode
  3. Configurer ton token
  4. Créer le projet (multi-agent)
  5. Appliquer les fichiers générés
  6. Tester localement
  7. Aller plus loin

0Prérequis

Avant de commencer, vérifie que tu as :

1Installer l'extension VSCode

  1. Télécharge le fichier gaadji-latest.vsix depuis ton dashboard
  2. Dans VSCode, ouvre le panneau Extensions (raccourci Ctrl+Shift+X ou Cmd+Shift+X)
  3. Clique sur le menu ⋯ en haut à droite du panneau, puis Install from VSIX...
  4. Sélectionne le fichier gaadji-latest.vsix téléchargé
  5. Recharge VSCode si demandé
💡 Astuce Tu peux aussi installer en ligne de commande : code --install-extension gaadji-latest.vsix.

2Configurer ton token Gaadji

L'extension a besoin de ton token API pour parler au backend Gaadji.

  1. Récupère ton token depuis ton dashboard (il est affiché une seule fois, après activation de la bêta)
  2. Dans VSCode, ouvre la palette des commandes (Ctrl+Shift+P / Cmd+Shift+P)
  3. Tape Gaadji : Configurer le token et entre
  4. Colle ton token gdj_... et valide

Tu devrais voir Gaadji ✓ dans la barre d'état de VSCode (en bas à droite).

3Créer le projet (multi-agent)

C'est le moment magique. Tu vas demander à Gaadji de générer une calculatrice Python avec ses tests, en mode multi-agent.

  1. Ouvre ton dossier ma-calculatrice dans VSCode (File → Open Folder)
  2. Ouvre la palette (Ctrl+Shift+P) → tape Gaadji : Lancer un projet (multi-agent)
  3. Une fenêtre te demande la description du projet. Colle ce texte :
Crée un module Python calculator.py avec 4 fonctions :
add(a,b), sub(a,b), mul(a,b), div(a,b) (lever ZeroDivisionError si b=0).
Ajoute un fichier tests/test_calculator.py avec pytest qui couvre les 4
fonctions plus le cas division par zéro. Fichiers attendus : 2.
  1. Choisis un cap budget : $0,50 est largement suffisant
  2. Le panneau Gaadji s'ouvre et affiche les phases en temps réel :
    • Phase 1 — orchestrateur + plan
    • Phase 2 — agent code + agent test (en parallèle)
    • Phase 3 — reviewer (vérification)

En 4 à 6 secondes, le run est terminé. Tu vois apparaître les 2 fichiers générés dans le panneau, avec leur taille et l'agent qui les a produits.

4Appliquer les fichiers

Les fichiers ne sont pas encore sur ton disque — Gaadji attend ta validation.

  1. Clique sur le bouton ▶ Apply All (en haut à droite du panneau)
  2. Une nouvelle fenêtre de prévisualisation s'ouvre, listant les 2 fichiers avec leur contenu
  3. Clique sur ✅ Tout créer

Les 2 fichiers sont écrits dans ton workspace :

ma-calculatrice/
├── calculator.py
└── tests/
    └── test_calculator.py
🔒 Sécurité par défaut Si l'un des fichiers existait déjà, son contenu original est sauvegardé automatiquement dans .gaadji-backups/. Tu peux annuler l'apply en bloc avec la commande Gaadji : Annuler le dernier Apply All multi-agent.

5Tester localement

Lance les tests générés pour vérifier que tout marche :

$ python -m pytest tests/ -v
================ test session starts ================
tests/test_calculator.py::test_add PASSED      [ 20%]
tests/test_calculator.py::test_sub PASSED      [ 40%]
tests/test_calculator.py::test_mul PASSED      [ 60%]
tests/test_calculator.py::test_div PASSED      [ 80%]
tests/test_calculator.py::test_div_by_zero PASSED [100%]
================ 5 passed in 0.02s =================

5/5 tests verts. Ton premier projet Gaadji est en place.

💡 Coût réel Sur la bêta, ce run coûte environ $0,005 (≈ 0,5 centime). Tu retrouves ce montant dans le compteur "Coût consommé" de ton dashboard.

6Aller plus loin

Maintenant que tu as la base, essaie des projets plus ambitieux :

Voir aussi :

Tu as un retour ou une question sur ce tutoriel ? Écris à beta@gaadji.com.