Voicebot Monorepo

Diese Repo enthält zwei aktive Projekte für den Unterricht mit Raspberry Pi, Calliope und lokaler KI.

Projekte

1. Calliope Flasher + Voicebot (calliope-flasher)

   • Flash-Weboberfläche für .hex Dateien (iPad/Safari)
   • Voicebot mit Calliope-Serial-Eingaben und TTS-Ausgabe
   • Projekt-README: flasher/README.md

2. DIY-AI Werkstatt (diy-ai)

   • Prompt-Workshop mit Live-Streaming + Sprache
   • Orchestrator + TTS-Service + Ollama
   • Projekt-README: diy-ai/README.md

Teaching-Material

• Schüler-Material: flasher/examples/schueler/README.md
• Lehrer-Material: flasher/examples/lehrer/README.md

Knopf-Verhalten (Voicebot)

• 1x drücken: kurzer KI-Kommentar
• 2x drücken: laufende Audioausgabe sofort stoppen
• 3x drücken: Presence Protocol auslösen

Schnellstart (alles zusammen)

Für den Betrieb auf einem Gerät mit Landing-Page und Slug-Routing:

./setup.sh --all
python3 hub/run_merged.py

Dann öffnen:

• Landing: http://voicepi-2.local/
• Calliope Flasher: http://voicepi-2.local/calliope-flasher/
• DIY-AI Werkstatt: http://voicepi-2.local/diy-ai/

Wichtige URLs lokal

Bei lokalem Start auf einem Rechner ohne Reverse-Proxy:

• Flasher direkt: http://localhost:1024
• DIY-AI direkt: http://localhost:8000
• TTS Health: http://localhost:8088/health

Konfiguration (Kurzüberblick)

Die zentrale Konfiguration liegt in .env im Repo-Root.

Wichtige Variablen:

• OLLAMA_SERVER – Ollama Endpoint (z. B. Mac im LAN)
• OLLAMA_MODEL – Modellname (z. B. gemma4:e4b)
• GLOBAL_VOLUME – globale Lautstärkeobergrenze
• REMOTE_TTS_ENABLED + REMOTE_TTS_URL + REMOTE_TTS_VOICE – steuern die Stimme für Button-/Joke-Ausgaben; für Anna muss Remote-TTS aktiv sein und REMOTE_TTS_VOICE=Anna gesetzt sein
• TTS_VOICE – lokale Fallback-Stimme (wenn Remote-TTS ausfällt oder deaktiviert ist, z. B. mb-de7 auf dem Pi)
• WORKSHOP_SERVER_TTS_PLAYBACK – false: Audio nur am Client, true: zusätzlich Pi-Lautsprecher (DIY-AI)
• HUB_VOICEBOT_SLUG – Standard: calliope-flasher
• HUB_WORKSHOP_SLUG – Standard: diy-ai

Startpunkt für Defaults: .env.example

Betrieb als Service (Pi)

sudo systemctl restart voicebot
sudo systemctl status voicebot

Service-Definition: voicebot.service

Repository-Struktur

voicebot/
├── README.md
├── main.py
├── flasher/                 # Calliope-Flasher + Voicebot-nahe Weboberfläche
├── diy-ai/                  # DIY-AI Workshop
├── hub/                     # Merged runner + Landing/Proxy
├── shared/tts-service/      # Gemeinsamer TTS-Service
├── setup/                   # Setup-Logik und Guides
├── examples/
│   ├── schueler/
│   └── lehrer/
├── requirements.txt
└── voicebot.service

Nächster Schritt

Für projekt-spezifische Details direkt in die jeweiligen READMEs gehen:

• flasher/README.md
• diy-ai/README.md