🚀 Guide de DĂ©marrage Rapide

Bienvenue dans le projet Robot Éducatif ! Ce guide vous aidera Ă  dĂ©marrer rapidement.

📩 Installation (5 minutes)

Étape 1 : VĂ©rifier Python

Ouvrez un terminal et tapez :

python --version

Vous devez avoir Python 3.7 ou plus récent. Sinon, installez-le depuis python.org.

Étape 2 : Installer les dĂ©pendances

Dans le dossier du projet, tapez :

pip install -r requirements.txt

Étape 3 : Lancer votre premier programme !

python robot_smile.py

🎉 FĂ©licitations ! Vous devriez voir un robot avec un sourire !

🎼 Essayer les Exemples

1. Sourire Simple (DĂ©butant)

python robot_smile.py
  • Appuyez sur ESPACE pour faire sourire le robot
  • Appuyez sur O pour ouvrir les yeux
  • Appuyez sur C pour fermer les yeux
  • Appuyez sur B pour cligner

2. DĂ©monstration des Émotions

python examples/emotions.py

Le robot montre automatiquement différentes émotions :

  • 😐 Normal
  • 😊 Heureux
  • 😮 FatiguĂ©
  • 😠 En colĂšre

3. Mode Interactif (Avancé)

python examples/interactive.py

ContrĂŽlez tout avec le clavier :

  • 1-4 : Changer d’émotion
  • +/- : Agrandir/rĂ©duire les yeux
  • A : Activer le clignement automatique

đŸ€– Passer au Robot RĂ©el

Une fois que vous maßtrisez la simulation, vous pouvez créer un vrai robot !

MatĂ©riel nĂ©cessaire (environ 20-30€)

  1. Raspberry Pi Pico (~5€) ou ESP32 (~8€)
  2. Écran OLED I2C 128x64 (~10€)
  3. Cñbles de connexion (~3€)
  4. Batterie USB (optionnel, ~10€)

Installation sur le robot

Consultez le guide détaillé dans micropython/README.md

📚 Apprendre Étape par Étape

Pour les Enfants (7-12 ans)

Semaine 1 : DĂ©couverte

  • Jour 1-2 : Lancer les programmes et observer
  • Jour 3-4 : Changer les Ă©motions avec les touches
  • Jour 5-7 : ExpĂ©rimenter avec les diffĂ©rents exemples

Semaine 2 : Personnalisation

  • Modifier la taille des yeux
  • Changer la vitesse de clignement
  • CrĂ©er sa propre sĂ©quence d’émotions

Semaine 3 : Programmation

  • Ouvrir le code et lire les commentaires
  • Modifier les couleurs (dans la version Pygame)
  • Ajouter de nouvelles touches au clavier

Semaine 4 : Projet Final

  • Concevoir son propre robot sur papier
  • Assembler le matĂ©riel
  • Programmer le comportement

Pour les Parents

Conseils pédagogiques :

  1. Commencez par jouer : Laissez votre enfant explorer les programmes
  2. Posez des questions : “Que se passe-t-il quand tu appuies sur cette touche ?”
  3. Encouragez l’expĂ©rimentation : “Et si on changeait ce nombre ?”
  4. CĂ©lĂ©brez les erreurs : Les bugs sont des opportunitĂ©s d’apprendre !
  5. Progressez doucement : Pas besoin de tout comprendre d’un coup

Concepts abordés :

  • ✅ Variables et constantes
  • ✅ Fonctions et paramĂštres
  • ✅ Boucles et conditions
  • ✅ ÉvĂ©nements et interactions
  • ✅ Graphiques et animations
  • ✅ Électronique de base (version matĂ©rielle)

🎯 DĂ©fis Amusants

DĂ©fi 1 : Le Robot Endormi

Modifiez robot_smile.py pour que le robot :

  1. Commence avec les yeux fermés
  2. S’ouvre lentement
  3. Sourit
  4. Se rendort aprĂšs 10 secondes

DĂ©fi 2 : Le Robot Musicien

Ajoutez des sons quand le robot change d’émotion ! (Indice : utilisez pygame.mixer)

DĂ©fi 3 : Le Robot Qui Suit la Souris

Faites en sorte que les yeux suivent le curseur de la souris (Indice : regardez robot_eye.py pour inspiration)

DĂ©fi 4 : Le Robot Parlant

Connectez un capteur de son et faites réagir le robot aux bruits !

🆘 Problùmes Courants

“ModuleNotFoundError: No module named ‘pygame’”

Solution : Installez pygame avec pip install pygame

“Permission denied”

Solution : Sur Linux/Mac, utilisez python3 au lieu de python

L’écran est tout noir

Solution : VĂ©rifiez que vous avez bien appuyĂ© sur ‘O’ pour ouvrir les yeux

Le programme ne répond pas

Solution : Appuyez sur ESC ou fermez la fenĂȘtre

📖 Ressources SupplĂ©mentaires

💡 IdĂ©es de Projets

  1. Robot de bureau : RĂ©agit quand vous vous approchez
  2. RĂ©veil mignon : Affiche l’heure avec des expressions
  3. Compagnon d’étude : Encourage pendant les devoirs
  4. DĂ©tecteur d’humeur : Change d’expression selon la mĂ©tĂ©o
  5. Robot messager : Affiche des notifications

🎓 Aller Plus Loin

Quand vous serez à l’aise :

  • Ajoutez des capteurs (distance, tempĂ©rature, lumiĂšre)
  • CrĂ©ez une interface web pour contrĂŽler le robot
  • Faites communiquer plusieurs robots ensemble
  • Ajoutez de la reconnaissance vocale
  • CrĂ©ez un jeu interactif avec le robot

đŸ€ Partager Vos CrĂ©ations

N’hĂ©sitez pas Ă  :

  • Prendre des photos/vidĂ©os de votre robot
  • Partager vos modifications du code
  • Inventer de nouvelles Ă©motions
  • CrĂ©er des tutoriels pour d’autres enfants

Amusez-vous bien et bon apprentissage ! đŸš€đŸ€–

Questions ? Consultez le README.md ou les commentaires dans le code !