ComputerVisionPRI25-26

Ce projet est une application web interactive combinant React (Frontend) et FastAPI (Backend) pour proposer des expériences de Vision par Ordinateur, notamment, il s'inscrit dans le cadre du Projet Recherche et Innovation qui se deroule au Semestre 9 à Polytech Tours:

• Dino Run Gesture Control : Contrôlez le jeu Dino avec des gestes de la main (Sauter = Changer de geste).
• Dobble Analysis : Détection et analyse de cartes Dobble.

📋 Prérequis

Avant de commencer, assurez-vous d'avoir installé :

• Python 3.12+ (Requis pour TensorFlow/MediaPipe)
• Node.js 18+ et npm

---

🛠️ Installation et Lancement

1. Récupération du projet

Clonez le dépôt GitHub :

git clone https://github.com/Isopope/ComputerVisionPRI25-26.git
cd ComputerVisionPRI25-26

2. Configuration du Backend (Python)

Le backend gère l'IA, la détection de gestes (MediaPipe) et l'analyse d'images (YOLO).

1. Ouvrez un terminal dans le dossier backend.
2. (Optionnel mais recommandé) Créez un environnement virtuel :

   python -m venv .venv
   # Windows
   .venv\Scripts\activate
   # Mac/Linux
   source .venv/bin/activate

3. Installez les dépendances :

   pip install -r requirements.txt

4. Assurez-vous que les modèles IA sont présents :
   • backend/dobble.pt (Modèle YOLO)
   • backend/model/keypoint_classifier/ (Modèle TFLite Gestes)
5. Lancez le serveur :

   uvicorn main:app --reload --host 0.0.0.0 --port 8000

   ✅ Le backend sera accessible sur : http://localhost:8000

3. Configuration du Frontend (React/Vite)

Le frontend est une application React utilisant Vite et ShadCN UI.

1. Ouvrez un nouveau terminal dans le dossier frontend.
2. Installez les dépendances :

   npm install

3. Lancez le serveur de développement :

   npm run dev

   ✅ Le frontend sera accessible sur : http://localhost:8080 (ou le port indiqué)

---

🚀 Utilisation

1. Une fois les deux serveurs lancés, ouvrez votre navigateur sur http://localhost:8080.
2. Accédez à un jeu .
3. Activez votre caméra lorsque demandé.
4. Mode IA pure : Accessible uniquement pour le jeu dobble, il permet de voir comment l'IA traite les informations qu'elle recoit .
5. Mode IA vs Humain : le mode challenge ou tu defis l'ia dans le jeu dobble, pour determiner qui trouve le symbole commun le plus vite.
6. Mode Explicatif : Cliquez sur le bouton "Mode Explicatif" pour comprendre comment l'IA traite les informations qu'elle recoit.