Setup & Basics Installation & bases
Work top to bottom. Tick every box — your progress is saved in this browser, so you can pause and come back. All terminal blocks have a Copy button. Avancez de haut en bas. Cochez chaque case — votre progression est enregistrée dans ce navigateur, vous pouvez faire une pause et revenir. Tous les blocs de terminal ont un bouton Copier.
1 · Create your free OpenRouter accountCréez votre compte OpenRouter gratuit
An OpenRouter account is free to create, and models ending in :free cost $0 per request. One catch: until you have bought any credit, you get only 50 free-model requests a day, and an agent like OMP can use those up in a single session. Adding $10 of credit once raises the limit to 1,000 a day, so we recommend doing it before class. OpenRouter is a single account that unlocks hundreds of models (Claude, GPT, Gemini, DeepSeek, Llama…) behind one API key.
La création d'un compte OpenRouter est gratuite, et les modèles se terminant par :free coûtent 0 $ par requête. Une limite toutefois : tant que vous n'avez acheté aucun crédit, vous n'avez droit qu'à 50 requêtes par jour sur les modèles gratuits, et un agent comme OMP peut les épuiser en une seule session. Ajouter 10 $ de crédit une fois fait passer la limite à 1 000 par jour : nous vous conseillons de le faire avant le cours. OpenRouter est un compte unique qui débloque des centaines de modèles (Claude, GPT, Gemini, DeepSeek, Llama…) derrière une seule clé API.
:free are routed by OpenRouter to whichever provider currently sponsors free capacity, at no charge. The lineup changes frequently — great for learning; for production work you'll later pick a paid model and see its exact price per million tokens. There is also an openrouter/free router that picks an available free model for you automatically.
Les identifiants se terminant par :free sont routés par OpenRouter vers le fournisseur qui offre actuellement de la capacité gratuite, sans frais. La liste change fréquemment — très bien pour apprendre ; pour un usage en production, vous choisirez plus tard un modèle payant et verrez son prix exact par million de tokens. Il existe aussi un routeur openrouter/free qui choisit automatiquement un modèle gratuit disponible.
2 · Install OMPInstaller OMP (Windows)(macOS)
OMP is the agent harness: the program that runs in your terminal, talks to OpenRouter, and can read files, run commands, and build things for you. OMP est l'harnais d'agent : le programme qui tourne dans votre terminal, dialogue avec OpenRouter, et peut lire des fichiers, exécuter des commandes et construire des choses pour vous.
Troubleshooting: omp is not recognizedDépannage : omp n'est pas reconnu
omp --version again. If it still fails, re-run the installer and read the PATH note it prints.
Presque toujours un problème de rafraîchissement du PATH : fermez toutes les fenêtres PowerShell/Terminal et rouvrez-en une nouvelle, puis relancez omp --version. Si cela échoue encore, réexécutez l'installateur et lisez la note PATH qu'il affiche.
Troubleshooting: zsh: command not found: ompDépannage : zsh: command not found: omp
~/.local/bin yet. Run the two PATH lines from step 3, or quit Terminal completely (⌘ Cmd+Q) and reopen it. To confirm the file is there, run ls ~/.local/bin/omp; you can always start it directly with ~/.local/bin/omp.
If your Terminal uses bash instead of zsh (older Macs — the prompt ends in $ and echo $SHELL shows /bin/bash), write the PATH line to ~/.bash_profile instead of ~/.zshrc.
If curl reports a network or certificate error, check you're not behind a proxy/VPN that blocks downloads and try again.
Later, if macOS pops up "The python3 / git command requires the command line developer tools" (usually the first time the agent runs Python or starts a local server), click Install — it's a free Apple download, takes a few minutes, and only happens once. Then ask OMP to retry.
Votre PATH n'inclut pas encore ~/.local/bin. Exécutez les deux lignes PATH de l'étape 3, ou quittez complètement Terminal (⌘ Cmd+Q) et rouvrez-le. Pour vérifier que le fichier est bien là : ls ~/.local/bin/omp ; vous pouvez toujours le lancer directement avec ~/.local/bin/omp.
Si votre Terminal utilise bash au lieu de zsh (Mac plus anciens — echo $SHELL affiche /bin/bash), écrivez la ligne PATH dans ~/.bash_profile au lieu de ~/.zshrc.
Si curl signale une erreur réseau ou de certificat, vérifiez qu'aucun proxy/VPN ne bloque les téléchargements, puis réessayez.
Plus tard, si macOS affiche « La commande python3 / git nécessite les outils de développement en ligne de commande » (souvent la première fois que l'agent lance Python ou un serveur local), cliquez sur Installer — c'est un téléchargement Apple gratuit, de quelques minutes, une seule fois. Demandez ensuite à OMP de réessayer.
3 · Launch OMP and connect it to OpenRouterLancer OMP et le connecter à OpenRouter
You remembered correctly: the connection happens through the browser. OMP opens a secure OpenRouter sign-in page, you approve it, and OMP saves the key — no copying secrets by hand. Vous vous souvenez bien : la connexion se fait via le navigateur. OMP ouvre une page de connexion OpenRouter sécurisée, vous l'approuvez, et OMP enregistre la clé — sans copier de secret à la main.
Alternative: log in without the wizard, or use an API keyAlternative : connexion sans l'assistant, ou avec une clé API
omp login openrouter (opens the same browser flow, then return to the terminal).
If you'd rather use a key directly: create one at openrouter.ai/keys
and either paste it into /login openrouter inside a session or put
OPENROUTER_API_KEY=sk-or-… in an .env file in your project folder.
Depuis le terminal, vous pouvez lancer omp login openrouter (même flux navigateur, puis retour au terminal).
Si vous préférez une clé directement : créez-en une sur openrouter.ai/keys
et collez-la dans /login openrouter dans une session, ou mettez
OPENROUTER_API_KEY=sk-or-… dans un fichier .env de votre dossier projet.
4 · Basics: /model, cost & performanceBases : /model, coût & performance
Switching modelsChanger de modèle
Inside an OMP session, type /model: a searchable list opens. Highlight a model and press Enter to switch mid-conversation — nothing else about your session changes. Try it now: type /model, search free, and watch what appears.
Dans une session OMP, tapez /model : une liste avec recherche s'ouvre. Sélectionnez un modèle et appuyez sur Entrée pour changer en pleine conversation — rien d'autre ne change dans votre session. Essayez : tapez /model, cherchez free, et regardez ce qui apparaît.
Understanding cost vs. performanceComprendre coût et performance
| ChoiceChoix | CostCoût | What you tradeCe que vous échangez | Use when…À utiliser quand… |
|---|---|---|---|
…:free models |
$0 | Rate-limited: 50 requests a day, or 1,000 once you have bought $10 of credit; lineup rotates; no SLA on speed or availability.Débit limité : 50 requêtes par jour, ou 1 000 après un achat de 10 $ de crédit ; la liste tourne ; aucune garantie de vitesse ni de disponibilité. | Learning, demos, light tasks — like today.Apprentissage, démos, tâches légères — comme aujourd'hui. |
openrouter/free |
$0 | Auto-picks an available free model; convenient, but you don't control which model answers.Choisit automatiquement un modèle gratuit disponible ; pratique, mais vous ne contrôlez pas quel modèle répond. | You just want it to work, no tuning.Vous voulez juste que ça marche, sans réglages. |
| Cheap paid (e.g. small Gemini/DeepSeek)Payant léger (ex. petit Gemini/DeepSeek) | ~$0.05–0.50 / 1M tok | Paid per use from your credit balance, with no daily request cap; far more reliable.Payé à l'usage sur votre solde de crédits, sans plafond journalier de requêtes ; nettement plus fiable. | Serious analysis on a budget.Analyse sérieuse à petit budget. |
| Frontier (Claude, GPT, Gemini Pro)Modèles de pointe (Claude, GPT, Gemini Pro) | $$–$$$ / 1M tok | Best accuracy and tool-calling, longest reliable context; pay for what the task needs.Meilleure précision et appels d'outils, contexte long fiable ; payez selon les besoins de la tâche. | High-stakes reports, complex data work.Rapports à fort enjeu, travail de données complexe. |
In OMP, the status line shows the model and running session cost ($0.0000 on free models); --warn-cost 1 and --max-cost 2 can cap spend on paid models. Bigger context windows handle larger datasets; faster tokens/second feels snappier; reasoning models think longer for harder questions. Rule of thumb: start free, upgrade only when the task demands it.
Dans OMP, la barre d'état affiche le modèle et le coût cumulé de la session (0,0000 $ pour les modèles gratuits) ; --warn-cost 1 et --max-cost 2 plafonnent la dépense sur les modèles payants. Une fenêtre de contexte plus grande accepte des jeux de données plus volumineux ; plus de tokens/seconde, c'est plus réactif ; les modèles de raisonnement réfléchissent plus longtemps pour les questions difficiles. Règle d'or : commencez gratuit, ne passez au payant que si la tâche l'exige.
poolside/laguna-s-2.1:free (coding-trained, 262 K context), with
nvidia/nemotron-3-ultra-550b-a55b:free as the heavy thinker (1 M context) if you hit its limits,
or openrouter/free to let OpenRouter pick.
Do it now: type /model and select one of these.
Notre tâche — analyser un CSV de 2 Mo et construire des diapositives HTML — est une tâche de code + données. Dans la liste gratuite du jour, les meilleurs choix sont :
→ poolside/laguna-s-2.1:free (entraîné au code, contexte 262 K), avec
nvidia/nemotron-3-ultra-550b-a55b:free en gros réfléchisseur (contexte 1 M) en secours,
ou openrouter/free pour laisser OpenRouter choisir.
Faites-le maintenant : tapez /model et sélectionnez l'un d'eux.
A handful of keystrokes worth knowingQuelques raccourcis à connaître
| Key / commandTouche / commande | Does whatEffet |
|---|---|
/model | Search & switch the model mid-session.Chercher et changer de modèle en cours de session. |
| Esc | Interrupt the agent when it goes the wrong way, then clarify.Interrompre l'agent s'il part dans la mauvaise direction, puis préciser. |
| Ctrl+O | Expand/collapse full tool output (see what it ran and read).Déplier/replier la sortie complète des outils (voir ce qu'il a exécuté et lu). On a Mac this is still Ctrl, not ⌘ Cmd.Sur Mac, c'est bien Ctrl, pas ⌘ Cmd. |
@file | Attach a file (e.g. the CSV) to your message.Joindre un fichier (ex. le CSV) à votre message. |
omp --continue | Reopen your last session in the same folder tomorrow.Rouvrir votre dernière session dans le même dossier demain. |
omp -p "…" | Script mode: answer and exit — automation without chat.Mode script : répondre et quitter — de l'automatisation sans conversation. |
5 · Hands-on: build the Nigeria LF presentationPratique : construire la présentation FL du Nigeria
Dataset: data-NG-lf-iu-2014-2025-20261028_150104.csv ↓ (2 MB) — Nigeria LF, IU-level, 2014–2025, Programme Data Portal.
Jeu de données : data-NG-lf-iu-2014-2025-20261028_150104.csv ↓ (2 Mo) — Nigeria FL, niveau IU, 2014–2025, Programme Data Portal.
Copy the class dataset data-NG-lf-iu-2014-2025-20261028_150104.csv into your amplify folder, then paste this prompt into OMP (adjust model/paths as needed):
Copiez le jeu de données du cours data-NG-lf-iu-2014-2025-20261028_150104.csv dans votre dossier amplify, puis collez cette consigne dans OMP :
Can't find the folder? Open it from the terminal (in a second window, or before launching omp): explorer . opens it in File Explorer.open ~/amplify opens it in Finder — your download is usually in Downloads; drag it across.
Vous ne trouvez pas le dossier ? Ouvrez-le depuis le terminal (dans une seconde fenêtre, ou avant de lancer omp) : explorer . l'ouvre dans l'Explorateur de fichiers.open ~/amplify l'ouvre dans le Finder — votre téléchargement est en général dans Téléchargements ; faites-le glisser.
You are a data analyst for a neglected tropical disease program.
The file data-NG-lf-iu-2014-2025-20261028_150104.csv in this folder is
Nigeria's lymphatic filariasis (LF) dataset from the Programme Data Portal:
774 implementation units (IUs), years 2014–2025, with columns for
endemicity status, population requiring MDA (popReq), population
treated (popTreat), and MDA round counts (cumMda).
Analyze it and build a self-contained HTML slide deck (max 5 slides,
keyboard navigation) for a technical meeting, showing the national
program's progress toward LF elimination. Include:
1. A title slide with headline numbers.
2. A national trend chart: population requiring MDA vs treated, by year.
3. A chart of IU counts by endemicity status across years
(MDA not delivered → under MDA → pending impact assessment →
post-intervention surveillance).
4. A state-level map (use natural breaks; add a legend and tooltips).
5. A closing slide: interpretation, remaining challenges, next steps.
Compute all numbers from the CSV itself. Use charts (e.g. Chart.js)
and a map library (e.g. Leaflet). Serve it locally so I can open it.Watch the agent read the CSV, compute aggregates, and write files. Steer it with follow-ups like "make the map show 2025 status only" or "the 2021 dip needs an annotation for COVID-19". When it claims to be done, open the page and check a number by hand — trusting the output is a skill you build. Regardez l'agent lire le CSV, calculer les agrégats et écrire des fichiers. Guidez-le avec des relances comme "affiche uniquement le statut 2025 sur la carte" ou "la baisse de 2021 mérite une annotation COVID-19". Quand il déclare avoir fini, ouvrez la page et vérifiez un chiffre à la main — faire confiance au résultat est une compétence qui se construit.
/model.
Sans achat de crédit, 50 requêtes par jour peuvent s'épuiser en pleine construction. Si vous voyez une erreur HTTP 429, vous avez atteint la limite : ajoutez 10 $ de crédit pour passer à 1 000 par jour, attendez la remise à zéro quotidienne (minuit UTC), ou passez à un autre modèle gratuit via /model.
What a good result looks likeÀ quoi ressemble un bon résultat
Open the reference deck →Ouvrir la présentation de référence →
The reference deck on this site was built from the same CSV. It is the answer key: your agent's output will (and should) look different — its numbers should not. La présentation de référence de ce site a été construite à partir du même CSV. C'est le corrigé : le rendu de votre agent sera différent (et c'est normal) — mais pas ses chiffres.