Skip to content

simon-266/tdot_programm

Repository files navigation

🎮 Schere Stein Papier - AI Edition

Willkommen zur interaktiven KI-Demo für den Tag der offenen Tür an der EDV-Schule Plattling!

Diese Anwendung demonstriert, wie moderne Computer Vision (Objekterkennung) funktioniert. Wir nutzen ein trainiertes YOLO Modell, um Handgesten (Schere, Stein, Papier) live über die Webcam zu erkennen und in ein spielbares Game zu verwandeln.

🌟 Spielmodi

Wir haben drei spannende Modi eingebaut:

  1. Singleplayer: Du spielst gegen den Computer. Die KI zählt runter und wählt zufällig eine Geste. Schaffst du es, sie zu schlagen?
  2. Multiplayer: Schnapp dir einen Freund! Die Kamera erkennt zwei Hände gleichzeitig und ermittelt automatisch den Gewinner zwischen euch beiden.
  3. Scan All: Ein offener Erkennungs-Modus, der einfach alles anzeigt, was die KI gerade sieht – perfekt zum Testen der Erkennungsgenauigkeit.

🚀 Installation & Start

Falls du das Projekt selbst auf deinem Laptop ausprobieren möchtest:

  1. Vorbereitung: Stelle sicher, dass Python (3.9 oder neuer) installiert ist.

    pip install -r requirements.txt

    Das installiert alle nötigen Bibliotheken wie ultralytics (für die KI), streamlit (für die Oberfläche) und opencv (für die Bildverarbeitung).

  2. Los Geht's: Starte die App einfach mit diesem Befehl:

    streamlit run main.py
  3. Bedienung:

    • Der Browser öffnet sich automatisch.
    • Wähle links deine Webcam und das KI-Modell aus.
    • Klicke auf "Kamera Starten" und dann "SPIEL STARTEN"!
    • Halte deine Hand gut sichtbar in die Kamera, wenn der Countdown endet.

📁 Projekt Struktur

Hier ein kleiner Überblick für Interessierte:

  • main.py: Das Herzstück der App – hier läuft alles zusammen (UI & Spiellogik).
  • src/detector/: Hier wohnt die KI-Logik (laden der Modelle, Bildanalyse).
  • src/game.py: Die Regeln für Schere-Stein-Papier.
  • runs/detect/: Ordner für trainierte YOLO-Modelle.
  • requirements.txt: Liste aller benötigten Pakete.

🛠 Hilfe bei Problemen

  • Kamera geht nicht? Prüfe, ob andere Programme (Teams, Zoom, etc.) die Kamera blockieren und lade die Seite neu.
  • Ruckelt es? Wähle in den Einstellungen links ein "Nano"-Modell oder aktiviere OpenVINO (falls du einen Intel-Chip hast).

Viel Spaß beim Spielen! 🤖🖐️

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages