NoteClaire：自托管 AI 笔记整理工具，帮学生把课堂笔记誊清

Remettre ses notes de cours au propre, avec une IA qui ne remplace jamais le travail de l'élève.

Site du projet · Pour les lycéens (seconde, première, terminale ; voies générale et technologique) · un espace par enfant · pensé pour les élèves dys · auto-hébergé, vos données restent chez vous

Principe

L'élève continue de prendre ses notes à la main en classe. À la maison, NoteClaire l'aide à :

saisir ses notes ou les photographier : l'IA recopie le texte sans rien corriger et signale les mots qu'elle n'a pas pu lire ;
remettre le cours au propre : orthographe, ponctuation et mise en forme, sans reformuler ni inventer ;
relire son cours : l'IA propose des corrections et des compléments en citant le programme officiel de sa classe, et c'est toujours l'élève qui accepte ou refuse ;
réviser : fiche de révision, quiz, export vers Anki.

L'IA ne remplace jamais silencieusement les notes de l'élève : les notes originales sont conservées et chaque modification se voit.

Fonctionnalités


Notes	Saisie au clavier ou photos de cahier (plusieurs pages), schémas découpés et redessinables, mots douteux signalés, historique des versions
Cours	Mise au propre en Markdown (encadrés, formules, schémas), comparaison avec les notes, éditeur visuel, versions, export PDF et Markdown
Relecture	Suggestions une par une, appuyées sur les programmes officiels et leur source ; « Je n'ai pas compris »
Révision	Fiche de révision, quiz (QCM, vrai/faux, réponse courte), export Anki
Famille	Un espace par enfant (classe, matières, particularités), données séparées côté serveur
Sécurité des données	Corbeille de 30 jours, sauvegardes quotidiennes, restauration vérifiée
IA au choix	Clé OpenAI, abonnement ChatGPT, ou modèle local (Ollama, LM Studio) ; budget mensuel réglable

Aperçu



Accueil : reprendre où l'on en était	Mes notes : la photo, le texte lu, les mots à vérifier

Mon cours : encadrés, formules, relecture	Réviser : fiche et quiz

Un espace par enfant	Thème crème, espacement aéré

Pensé pour les élèves dys

Police Lexend (conçue pour la lisibilité), texte jamais justifié, ni en majuscules, ni en italique, lignes courtes.
Grands boutons et grandes cases à cocher ; une seule action principale par étape.
Thème Crème, espacement des lettres et des mots, taille du texte, thème sombre.
Particularités de l'élève (dyslexie, dyspraxie, TDAH…) transmises à l'IA pour adapter ses explications et ses fiches.
Contrastes et libellés contrôlés automatiquement dans chaque thème.

Installation

Il faut seulement Docker (Docker Desktop sur Windows et Mac). Le script télécharge la configuration, choisit un mot de passe, démarre l'application et ouvre le navigateur.

Linux et Mac :

curl -fsSL https://raw.githubusercontent.com/jogit/noteclaire/main/scripts/install.sh | sh

Windows (PowerShell, Docker Desktop lancé) :

irm https://raw.githubusercontent.com/jogit/noteclaire/main/scripts/install.ps1 | iex

L'application est ensuite sur http://localhost:8080 ; le mot de passe généré est dans ~/noteclaire/.env. Au premier accès, un assistant demande le prénom et la classe de l'élève, puis le choix de l'IA, qu'il teste (clé OpenAI, compte ChatGPT, IA locale, ou « Essayer sans IA »). Il propose ensuite de télécharger les programmes officiels de la classe, pour que la relecture cite ses sources.

Mettre à jour : relancer la même commande (le .env et les données sont conservés).
Arrêter : cd ~/noteclaire && docker compose down.
Photographier avec un téléphone : demande HTTPS, proposé par le script. Voir Configuration.

Installation manuelle ou depuis les sources

Avec les images publiées : enregistrez docker-compose.yml à côté d'un .env (modèle : .env.example), puis docker compose up -d.

Pour compiler les images vous-même :

cp .env.example .env
# Dans .env : APP_PASSWORD
docker compose up -d --build

Port 8080 occupé : HTTP_PORT=8081 dans .env.

Documentation

Guide d'utilisation : photos et schémas, relecture, révision, plusieurs enfants, sauvegardes et restauration.
Configuration : choix de l'IA, programmes officiels, HTTPS, variables.
Dépannage : erreurs Docker, mot de passe perdu, caméra, ChatGPT.
Cahier des charges : périmètre, architecture, modèle de données.

Vie privée et sécurité

Auto-hébergé : base SQLite et fichiers dans vos volumes Docker, rien ne part vers un service de NoteClaire. Seul le texte envoyé à l'IA que vous choisissez quitte la maison (jamais avec une IA locale).
Les métadonnées des photos (dont la position GPS) sont retirées avant tout envoi à l'IA.
Accès protégé par un mot de passe (obligatoire dès que d'autres appareils s'y connectent) ; chaque enfant n'accède qu'à ses chapitres.
Clés et jetons chiffrés au repos, jamais renvoyés au navigateur ni sauvegardés.

Développement

Python 3.12 + uv, Node 22.

make install        # dépendances
make dev-backend    # API sur http://localhost:8000
make dev-frontend   # application sur http://localhost:5173
make check          # lint + types + tests (ce que la CI exécute)
make coverage       # couverture

Tests de bout en bout (Playwright) sur l'application lancée : cd frontend && npx playwright install chromium && npm run e2e.

Pile technique : FastAPI, SQLAlchemy, SQLite (FTS5), Alembic · Vue 3, TypeScript, Vite, TipTap, KaTeX, Mermaid. Les règles de développement sont dans AGENT.md.

Licence

NoteClaire est publié sous GNU AGPL-3.0 : libre pour les particuliers et les familles, qui peuvent l'installer, le modifier et le partager. Quiconque le propose en service à d'autres personnes doit publier ses modifications sous la même licence. Voir aussi NOTICE, composants tiers, SECURITY.md (signaler une faille) et CONTRIBUTING.md.

NoteClaire ne contient aucun document officiel : les programmes de l'Éducation nationale sont téléchargés, à votre demande, depuis les sites officiels (voir Configuration).