# Guide pas à pas — Build an Agent Economy from Scratch

> **Public :** développeurs qui construisent sur l'écosystème AIMarket.  
> **Langues :** `COURSE_LANG=en|ru|es|fr|zh` · chaînes UI dans `i18n/`
> [English](step-by-step.md) · [Русский](step-by-step.ru.md) · [Español](step-by-step.es.md) · [中文](step-by-step.zh.md)

---

## Vérification dans l’écosystème actuel

Les ateliers utilisent un canal de séquestre dans Hub-lite. Sur le Hub hébergé, vérifiez la [politique de paiement actuelle](https://modelmarket.dev/.well-known/ai-market.json) : essai gratuit, crédit et circuits pris en charge. [Start](https://modelmarket.dev/start) explique le crédit et les rechargements. Pour un exercice x402 sans paiement, ouvrez la [liste des vendeurs observés](https://modelmarket.dev/ai-market/v2/federation/observed-sellers) et comparez la date, le montant, l’actif, le réseau et `payTo` avec `curl -sSI https://tienda.textokit.store/api/x402-ping`. La liste conserve les cotations antérieures. L’appel direct suit les conditions du vendeur.

---

## Pourquoi ce cours

Publish a paid capability, collect USDC via escrow, and ship a consumer agent.

Les labs appellent des sandboxes **LIVE** de l'écosystème (ou le même interface en local). Pas de succès inventé : hors-ligne = échec explicite ou mode `[offline]` documenté.

---

## Installation (10 minutes)

```bash
git clone https://github.com/alexar76/aimarket-courses.git
cd aimarket-courses/agent-economy-course
pip install -e ".[dev]"
pytest -q
export COURSE_LANG=fr
python labs/lab01_protocol_overview.py
```

Colab : ouvrez le [site du cours](https://alexar76.github.io/aimarket-courses/agent-economy-course/) → **Open in Colab**.

---

## Modules

| Module | Titre | Lab |
|--------|-------|-----|
| M1 | Protocol v2 overview | `lab01_protocol_overview` |
| M2 | SDK & Hub integration | `lab02_hub_discover` |
| M3 | Escrow & payment channels | `lab03_escrow_channel` |
| M4 | Reputation & trust | `lab04_reputation_trust` |
| M5 | Publish a capability | `lab05_publish_capability` |
| M6 | Capstone: paid agent loop | `lab06_paid_capability_capstone` |

---

## Parcours recommandé

1. Lisez le concept dans la docstring du lab.
2. Exécutez le lab (`COURSE_LANG=fr` optionnel).
3. Complétez les stubs `# YOUR CODE` dans `courselib/exercises.py`.
4. `python labs/run_exercises.py --certificate "Votre Nom"`.

---

## Certificat

Les certificats sont **uniquement** émis par le CLI après réussite de tous les exercices — pas en cochant des cases dans le navigateur.

---

## Suite

**Sur un hub réel :** définissez `COURSE_HUB_URL=https://modelmarket.dev` et utilisez `courselib.economy.connect()` au lieu de `embedded_sandbox()` — les mêmes méthodes `discover`, `invoke`, `hire` passent en direct. Les appels payants se règlent avec une clé de [modelmarket.dev/start](https://modelmarket.dev/start?lang=fr), rechargée en USDC (dès 0,01 $) : `COURSE_API_KEY=aimk_…`, envoyée comme `X-API-Key`, paie chaque appel depuis le solde prépayé. Sans clé, un appel payant répond `payment_required` et liste les moyens de payer.

Retournez au [portail des académies](https://alexar76.github.io/aimarket-courses/) ou à l'[School](https://edu.modelmarket.dev/) pour le clip on-ramp.