L'énoncé (pdf/tex) et le corrigé sont analysés
Les labels des questions sont détectées sur les copies.
Les copies sont découpées suivant ces labels.
Des requêtes de correction sont faites à Gemini, qui met une note entre 0 et 4 à la question, ajoute des commentaires, et encadre certaines parties de la réponse.
Une version pdf annotée de la copie est générée, faite pour être éditée sur tablette tactile. Le correcteur humain peut modifier la note, supprimer des commentaires de l'IA, ou ajouter des remarques manuscrites.
Ces annotations manuscrites sont lues et recompilées en une version de la copie pour l'élève.

Le dossier `Example` contient deux exemples de copies pour illustrer le résultat final.

Reprendre une compilation LaTeX après l'analyse

Les PDF des questions et solutions reprennent automatiquement les packages et macros de enonce.tex et du corrigé, avec le format recadré de Copienator. La géométrie des pages du document original est exclue pour préserver le recadrage. Les packages et fichiers locaux doivent rester accessibles à LaTeX.

Pour recompiler les fragments déjà extraits sans aucune requête Gemini :

python -m copienator statement DSI01 --compile-only

Dans l'interface, choisir « Recompiler les PDF sans Gemini » à l'étape « Analyser l’énoncé ». Cette action conserve les sources, les groupes et les barèmes. Elle reprend les échecs et recompile si les fragments ou leur préambule ont changé. Une compilation en erreur ne remplace pas le PDF précédent.

Avertissements

90% du code du repertoire a été vibe codé, sans vérification autre que le fait que ça marche sur ma machine.
Il en va de même d'une grande partie de la documentation, et le workflow n'est probablement pas compréhensible en l'état. Cette situation s'améliorera légèrement quand j'aurai convaincu quelques collègues du lycée de me laisser les accompagner pour essayer.

Limitations

Pour l'instant, la correction est faite question par question : le LLM n'a accès qu'à la partie de la copie correspondant à une question fixée. Ça ne gère donc pas les cas où un argument a été donné dans une question précédente ou autre.

Noms de labels sous Windows

Les labels de questions sont utilisés comme noms de fichiers. Les labels contenant notamment : ne sont pas acceptés par Windows.

Prérequis et installation

Python 3.11 ou plus récent

Sous macOS avec Homebrew, installer Python et la version correspondante de Tkinter avant de créer l'environnement virtuel. Par exemple :

brew install python@3.13 python-tk@3.13

Utiliser alors python3.13 à la place de python dans les commandes de création de l'environnement si la commande non versionnée n'est pas disponible.

Créer et activer un environnement virtuel est recommandé :

python -m venv .venv

Sous Linux et macOS :

source .venv/bin/activate

Sous Windows (PowerShell) :

.venv\Scripts\Activate.ps1

Installer ensuite Copienator et ses dépendances Python depuis la racine du dépôt :

python -m pip install --upgrade pip
python -m pip install -e .

Cette commande installe les modules contrôlés par le diagnostic du GUI (NumPy, pandas, Matplotlib, Pillow, pydantic, pypdf, pdf2image, ReportLab, img2pdf, PyMuPDF, ftfy, ezodf et Google Gen AI), ainsi que les exécutables copienator et copienator-gui. Le paquet fournissant google.genai est google-genai, et non google.

Les commandes restent également accessibles avec python -m copienator depuis la racine du dépôt.

Programmes externes obligatoires

Le diagnostic vérifie que Poppler et LaTeX sont accessibles depuis PATH.

Linux (Debian et Ubuntu)

sudo apt install poppler-utils python3-tk texlive-latex-extra texlive-fonts-extra lmodern python3-pygments

Cette sélection couvre les modèles LaTeX de la configuration par défaut, notamment standalone, lmodern, mathabx et minted. Selon les commandes LaTeX utilisées dans vos propres énoncés, d'autres paquets TeX peuvent être nécessaires. python3-tk fournit Tkinter sur les installations Python qui ne l'incluent pas d'origine.

Windows

Télécharger Poppler pour Windows et ajouter son dossier bin à PATH.
Installer une distribution LaTeX, par exemple MiKTeX ou TeX Live, et vérifier que pdflatex est accessible depuis PATH.

Fermer puis rouvrir le terminal et le GUI après une modification de PATH.

macOS

Avec Homebrew, installer Poppler et MacTeX :

brew install poppler
brew install --cask mactex

MacTeX fournit la distribution TeX Live complète utilisée par les modèles de Copienator. Après son installation, rouvrir le terminal ou exécuter :

eval "$(/usr/libexec/path_helper)"

Copienator recherche aussi les exécutables dans /opt/homebrew/bin, /usr/local/bin et /Library/TeX/texbin, notamment lorsque le GUI ne récupère pas le PATH du terminal. Ces instructions conviennent aux Mac Intel et Apple Silicon sous macOS 11 ou plus récent.

Programme externe facultatif

PDF Arranger permet d'ouvrir et de réorganiser plus facilement les PDF. Son absence est signalée comme facultative dans le diagnostic. Il doit fournir la commande pdf-arranger ou pdfarranger dans PATH. Sous macOS, Copienator utilise automatiquement Aperçu comme solution de repli.

Accès à Gemini

Il faut créer une clef API pour Gemini (pas facile).

Puis ajouter GEMINI_API_KEY à l'environnement avec :

export GEMINI_API_KEY=…

ou éventuellement, la renseigner directement dans le fichier `config.py`.

Configuration

Copier `default_config.py` en `config.py`. Éventuellement le modifier. Les options absentes conservent leur valeur par défaut. La variable COPIENATOR_CONFIG permet de choisir un autre fichier global.

Chaque dossier d'évaluation peut aussi contenir un config.py avec seulement les options à remplacer, par exemple :

RETURN_PDF_ENABLED = False
MODEL_FLASH_ID = "gemini-3.8-flash"

Ces options prennent le dessus sur la configuration globale, y compris celle choisie par COPIENATOR_CONFIG. Les autres options restent héritées. Les chemins relatifs gardent leur interprétation depuis le dossier de lancement. Les options explicites des commandes prennent le dessus sur la configuration locale. L'interface recharge ces options quand on ouvre une évaluation.

Un fichier names dans le dossier d'évaluation remplace entièrement celui du dossier de lancement, sans fusion des listes. En son absence, le fichier global names reste utilisé. Une liste locale vide est également prioritaire.

Les niveaux de réflexion Gemini se règlent indépendamment des modèles : THINKING_LEVEL_LITE (énoncés, "low"), THINKING_LEVEL_FOR_LABEL (labels, "medium"), THINKING_LEVEL_FLASH (correction courante, "medium") et THINKING_LEVEL_PRO (correction difficile, "high"). Ces réglages s'appliquent aussi aux requêtes batch. Utiliser None pour laisser le modèle choisir son défaut. Les niveaux disponibles dépendent du modèle : Gemini 3.8 Flash accepte "low", "medium" et "high", mais pas "minimal". Avec un modèle Gemini 2.5, utiliser None.

Correction d'un paquet de copies

Créer un fichier names dans le dossier courant, avec les noms/prénoms des élèves, un par ligne
Créer un dossier correspondant à l'évaluation (Interro dans la suite)
Lancer l'interface graphique

Interface graphique

Lancer l'assistant avec :

python -m copienator gui

./start-gui.sh

Documentation complémentaire

Guide utilisateur de l’interface graphique : actions, vérifications et cas particuliers pour chaque étape du parcours non personnel.
Référence des étapes et des scripts : commandes, arguments, prérequis, fichiers produits et parcours alternatifs.
Fichiers finaux dans A Rendre : contenu du JPEG, sélection et pagination du PDF, JPEG par réponse, score.json, info.json et diffusion.
Architecture et conventions de développement : API commune, état partagé, écritures sûres et règles de maintenance.

Readme.org Unescape Escape

Copienator

Présentation

Quézaco