Studium
Studium transforme des sources que vous jugez fiables en leçons adaptatives, à suivre dans VS Code ou avec votre propre assistant IA. Chaque réponse dit qui a rédigé la clé de correction et si quelque chose l'a évaluée.
eDIAM · Institut de Chimie de Nice · Université Côte d'Azur · CNRS · HolobiomicsLab · Site de Studium
Commencer ici
Studium a deux parties. Savoir laquelle fait quoi évite de chercher :
| Partie | Ce qu'elle fait | Ce qu'elle ne fait pas |
|---|---|---|
| Votre assistant IA, relié au serveur Studium | construit une leçon à partir des sources que vous indiquez, vous pose ses questions dans la conversation, ramène les idées les jours suivants | répondre à votre place |
| L'extension VS Code | affiche une leçon dans un panneau, avec ses figures, ses équations et ses révisions | construire une leçon : sur une machine neuve, sa vue Leçons reste vide tant qu'un assistant n'en a pas construit une |
Une nouvelle leçon commence donc toujours dans un assistant.
1. Relier votre assistant
Il vous faut Node 20 ou plus (node --version). Lancez une fois la ligne de votre assistant, puis
redémarrez-le :
| Assistant | Commande |
|---|---|
| Claude Code | claude mcp add --scope user studium -e LITELLM_BASE_URL= -- npx -y studium-mcp |
| Codex | codex mcp add studium --env LITELLM_BASE_URL= -- npx -y studium-mcp |
| Copilot dans VS Code, mode agent | code --add-mcp '{"name":"studium","command":"npx","args":["-y","studium-mcp"],"env":{"LITELLM_BASE_URL":""}}' |
Cursor, OpenCode et Claude Desktop, ainsi que le plugin Claude Code qui apporte aussi les skills, sont sur
la page Installation. LITELLM_BASE_URL= (vide) empêche Studium
d'appeler un modèle payant. Quel modèle utiliser, avec un abonnement Copilot ou un modèle sur votre
machine : Choisir son modèle.
2. Demander une leçon
Dans une nouvelle conversation, avec vos mots :
Je veux apprendre comment fonctionne le cycle de l'eau avec Studium. Sers-toi de ces deux pages : (deux liens en lesquels vous avez confiance).
L'assistant construit une leçon à partir de vos sources, vous en montre le plan, puis pose la première
question. Vous répondez ; il transmet vos mots. La leçon est enregistrée dans ~/.studium/library et votre
progression dans ~/.studium/data. Chaque étape est décrite dans
Apprendre avec votre assistant.
3. La jouer dans VS Code (facultatif)
code --install-extension holobiomicslab.studium-vscode
Ouvrez l'icône Studium dans la barre d'activité : la leçon construite par votre assistant est dans la vue Leçons (utilisez son bouton de rafraîchissement si VS Code était déjà ouvert), sauf si vous avez choisi un autre dossier de leçons. Vous pouvez aussi demander à l'assistant d'ouvrir la leçon dans VS Code. Le panneau garde sa propre progression, distincte de celle de la conversation. Voir VS Code.
Si vous êtes un assistant IA qui aide quelqu'un avec Studium
Ces étapes sont écrites pour vous.
- Vérifiez Node :
node --versiondoit afficher 20 ou plus. - Déclarez le serveur avec la ligne de l'étape 1 qui correspond à votre harnais. Laissez
LITELLM_BASE_URLvide sauf si la personne demande un modèle juge : une valeur non vide est une route payante. - Après le redémarrage, prouvez la connexion en appelant
get_server_info: il renvoie la version et la liste des outils. Un fichier de configuration n'est pas une preuve. - Appelez
get_study_planavec unlearner_idstable et la langue de la personne. Sonnext_stepnomme l'appel suivant ; sans leçon, il vous envoie versget_authoring_guide, puisprepare_sourcesetcreate_lesson. - L'apprenant répond et vous transmettez : ne répondez, ne choisissez et ne notez jamais à sa place, et ne
lisez pas le corrigé d'une leçon. Affichez chaque
display_markdowntel quel. - Une leçon que vous rédigez n'est pas approuvée par un enseignant : transmettez l'avis de son premier écran.
Le serveur répète ces règles dans ses propres instructions à la connexion. Détails :
Connecter votre assistant, le skill
studium-harness et les outils MCP.
Pour modifier le code de Studium, lisez plutôt AGENTS.md.
Choisir son parcours
| Je veux… | Commencer ici | Ce que vous obtenez |
|---|---|---|
| Apprendre seul un sujet avec un assistant IA | Apprendre avec votre assistant | Une leçon construite à partir des sources choisies, puis des révisions espacées les jours suivants |
| Étudier dans une classe | Guide étudiant | Une leçon approuvée par l'enseignant, dans VS Code ou dans votre assistant, avec un retour après chaque réponse |
| Enseigner | Guide enseignant | Une leçon sourcée, un enregistrement d'approbation lié à son contenu exact et un rapport de classe agrégé |
| Construire sur Studium | Architecture et outils MCP | Les contrats du moteur, les 40 outils MCP et le format des leçons |
Le portail de la documentation classe toutes les pages par rôle. Les mêmes pages se construisent en un site avec
un menu, une recherche, les deux langues et les thèmes clair et sombre, lisible sans réseau :
node tools/docs/build-site.mjs --out site, puis ouvrez site/fr/index.html.
![]() Une étape de quiz dans le panneau de leçon de VS Code ; l'avis en tête dit qui a écrit la clé de correction. |
![]() Le retour après une réponse rédigée qu'aucun juge n'a évaluée : comparer aux points clés, puis évaluer son rappel. |
Depuis un clone, avec les leçons de démonstration
Ce parcours est pour les enseignants et les contributeurs, et vous donne les leçons de démonstration. Prévoyez un quart d'heure environ. Il vous faut git, Node 22 et pnpm 9. Python n'est pas nécessaire pour apprendre.
git clone https://github.com/HolobiomicsLab/studium.git
cd studium
corepack enable # provides the pnpm version pinned in package.json
./setup.sh # installs, builds the libraries and the VS Code extension
Si le clonage répond Repository not found, le dépôt n'est pas encore visible depuis votre compte : lancez gh auth login puis clonez à nouveau.
Dans VS Code. Installez l'extension avec les deux commandes ci-dessous, puis lancez Studium : Choisir un cours et choisissez le dossier fixtures pour les leçons de démonstration, qui n'exigent aucune clé d'API. Les contributeurs peuvent appuyer sur F5 dans apps/studium-vscode. Voir VS Code et Installation.
pnpm --filter studium-vscode package
code --install-extension apps/studium-vscode/studium.vsix
Dans votre assistant IA. Déclarez, depuis la racine du dépôt, le serveur Studium construit par setup.sh (MCP est le protocole par lequel un assistant appelle des outils). LITELLM_BASE_URL= (vide) indique à Studium de n'utiliser aucun modèle juge, même si votre shell en définit un.
# Claude Code
claude mcp add --scope project studium -e LITELLM_BASE_URL= -- node "$PWD/apps/studium-vscode/dist/lesson-mcp.cjs"
# Codex
codex mcp add studium --env LITELLM_BASE_URL= -- node "$PWD/apps/studium-vscode/dist/lesson-mcp.cjs"
Redémarrez l'assistant et demandez : « Je veux apprendre la photosynthèse avec Studium ». L'assistant demande des sources, construit une leçon, puis vous pose la première question. Votre progression est conservée dans ~/.studium/data ; les leçons que vous créez vont dans ~/.studium/library. Copilot, OpenCode et Cursor sont décrits dans Connecter votre assistant. Pour aller plus loin : démarrage rapide et dépannage.
Ce qui distingue Studium
- Un cours est un graphe. Chaque leçon relie ses concepts par leurs prérequis ; navigation, remédiation et vue enseignant le lisent. Comment fonctionne Studium
- Une évaluation honnête, dont on connaît l'origine. Chaque leçon dit qui a rédigé la clé de correction et si un modèle juge a évalué la réponse. Honnêteté et provenance
- Des leçons sourcées. Chaque item noté cite un passage, et chaque citation doit correspondre à sa source au caractère près.
- Des révisions espacées. Studium planifie les révisions (FSRS) ; votre auto-évaluation ne modifie jamais la maîtrise mesurée. Réviser dans la durée
- Local d'abord. L'état de l'apprenant reste sur votre machine, sous pseudonyme, et vous pouvez l'effacer. Confidentialité et limites
- N'importe quel harnais. Un seul contrat de séance sur MCP, une API HTTP locale et un canal fichier ; l'assistant relaie, l'apprenant répond.
État et limites
Studium est un prototype de recherche, en version 0.6.3. Le moteur adaptatif, les outils d'auteur, les enregistrements de provenance et le banc d'évaluation sont implémentés et testés, mais l'effet de Studium sur les apprentissages n'a pas été évalué. Un enseignant doit relire et approuver une leçon avant que des étudiants l'utilisent. Une leçon construite par un assistant IA à partir de vos sources est signalée comme rédigée par un agent et non validée par un enseignant. Sans modèle juge configuré, les réponses ouvertes sont comparées à la référence plutôt que notées. L'adaptateur HTTP expose les 25 opérations de leçon et rate_recall ; les autres outils d'étude et tous les outils d'auteur et enseignant n'existent que par MCP. Le workflow de version peut publier sur la Marketplace VS Code, Open VSX et npm dès que leurs jetons sont configurés ; d'ici là, une version est une release GitHub en brouillon avec le VSIX et le fichier du serveur.
- Capacités, surfaces et maturité : ce que fait chaque surface et jusqu'où elle est prise en charge.
- Architecture et carte du dépôt : le schéma, chaque application, paquet et service.
- Captures de la bibliothèque enseignant et de la carte des notions.
Une famille de projets
Studium assemble quatre projets frères du laboratoire : Perspicacité ancre les prérequis dans des passages de la littérature, indicium représente le graphe sous forme d'assertions liées à leurs preuves, ASTRA enregistre chaque décision d'adaptation pour qu'on puisse la rejouer, et ASB fournit les capsules de reproduction et le standard d'étape agentique.
Qui fait Studium
Studium est développé par le HolobiomicsLab, au sein de l'équipe eDIAM (Équipe d'Intelligence Artificielle pour les Sciences Moléculaires) de l'Institut de Chimie de Nice (ICN, UMR 7272), Université Côte d'Azur et CNRS.
Nous remercions l'EUR Spectrum, école universitaire de recherche en sciences fondamentales et ingénierie d'Université Côte d'Azur, pour son soutien. Studium est né de questions d'enseignement soulevées autour de l'école.
Licence
Le code est distribué sous licence Apache 2.0. La documentation, l'identité visuelle et les leçons écrites par le projet sont sous licence Creative Commons Attribution 4.0. Les extraits de sources cités dans une leçon gardent leur propre licence, indiquée sur chaque ligne de source, et une leçon construite à partir de vos propres sources vous appartient. Le matériel pédagogique tiers utilisé par le banc d'évaluation sous eval/corpus/ n'est pas redistribué ; son manifeste indique la licence de chaque source. Le fichier NOTICE précise quelle licence couvre quel dossier.
Citer Studium
Si vous utilisez Studium dans un travail de recherche, citez-le avec les métadonnées de CITATION.cff. GitHub en tire un bouton « Cite this repository ». Aucun DOI n'est encore attribué.
Contribuer et sécurité
Signaler un problème ou contribuer · Contribuer · Code de conduite · Politique de sécurité · Tester Studium · Journal des modifications (en anglais)

