README.md

metadata

title: IA Génération d'images
emoji: 🎨
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 5.50.0
app_file: app.py
pinned: false

Atelier IA — page de classe (fal.ai)

Page web pour que les étudiants génèrent des images avec vos crédits fal.ai, sans jamais voir la clé API.

• Texte → Image : Krea 2 Turbo, Z-Image Turbo + templates de prompts (CSV)
• Image → Image : Nano Banana 2 (édition), Seedream 5 Pro (édition), 1 à 4 images de référence
• Ma galerie : images de l'étudiant, prompt, réutilisation comme référence, export .zip (avec prompts.csv)
• Enseignant : crédits par étudiant, quota, remise à zéro, import des templates de classe, galeries des étudiants

Connexion

• Étudiant : identifiant = son prénom (ou pseudo), mot de passe = le code de classe (CLASS_CODE)
• Enseignant : identifiant prof, mot de passe ADMIN_CODE → l'onglet « Enseignant » apparaît

Chaque identifiant a sa propre galerie : les étudiants doivent toujours utiliser le même.

Crédits

Chaque étudiant a un quota (60 crédits par défaut, modifiable dans l'onglet Enseignant). Texte → Image = 1 crédit/image, édition = 4 crédits/image (réglable dans app.py, dictionnaires T2I_MODELS / I2I_MODELS). Les images bloquées par le filtre de sécurité ne sont pas décomptées. Côté fal.ai, ne rechargez que le budget prévu : le solde ne peut pas passer en négatif.

Option A — Hugging Face Spaces (en ligne, gratuit)

1. Sur huggingface.co : New Space → SDK Gradio → matériel CPU basic (gratuit) → visibilité Public (l'accès reste protégé par le code de classe ; un Space privé n'est accessible qu'aux comptes autorisés).
2. Onglet Files → Upload files : app.py, requirements.txt, templates_exemple.csv, README.md.
3. Settings → Variables and secrets → New secret :
   • FAL_KEY = votre clé fal.ai
   • CLASS_CODE = code de la classe
   • ADMIN_CODE = votre mot de passe enseignant
   • (optionnel) QUOTA = 60
4. Sauvegarde des galeries (recommandé) : le disque d'un Space gratuit est effacé à chaque redémarrage. Ajoutez aussi les secrets HF_TOKEN (jeton Write créé dans Settings → Access Tokens de votre compte) et DATA_REPO = votre-nom/atelier-ia-data. Les galeries sont copiées toutes les 2 min dans un dataset privé et restaurées au redémarrage.
5. Donnez aux étudiants l'adresse directe du Space : https://votre-nom-nom-du-space.hf.space (la connexion fonctionne mal dans la page huggingface.co/spaces/… à cause des cookies).

Un Space gratuit se met en veille après 48 h sans visite : ouvrez-le quelques minutes avant le cours.

Option B — Sur votre PC pendant le cours

1. Installez Python 3.10+ (cochez « Add Python to PATH »).
2. Ouvrez lancer_windows.bat avec le Bloc-notes, remplissez FAL_KEY, CLASS_CODE, ADMIN_CODE, enregistrez.
3. Double-cliquez dessus. Les étudiants sur le même Wi-Fi ouvrent http://<IP de votre PC>:7860 (IP donnée par la commande ipconfig). Autorisez Python dans le pare-feu Windows si demandé.
4. Les images restent dans le dossier data/.

Format des templates CSV

Colonnes categorie, titre, prompt — séparateur ; ou ,, UTF-8 ou export Excel. Voir templates_exemple.csv (14 templates animation 2D, chargés automatiquement au premier lancement). L'import dans l'onglet Enseignant remplace les templates de classe. Les étudiants peuvent importer leurs propres templates (marqués ★, visibles d'eux seuls).