| --- |
| 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). |
|
|
