Add files via upload
This commit is contained in:
Kenearos
GitHub
parent
f06f078eab
commit
d992aabc70
2 changed files with 957 additions and 0 deletions
865
eugen_claude.md
Normal file
865
eugen_claude.md
Normal file
|
|
@ -0,0 +1,865 @@
|
||||||
|
# Eugen – Intelligenter Gaming & 3D-Druck Twitch-Bot
|
||||||
|
## Komplettes Setup & Implementierungs-Guide für Windows
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 Inhaltsverzeichnis
|
||||||
|
|
||||||
|
1. [Überblick](#überblick)
|
||||||
|
2. [Systemanforderungen](#systemanforderungen)
|
||||||
|
3. [Installation & Setup](#installation--setup)
|
||||||
|
4. [Konfigurationsassistent](#konfigurationsassistent)
|
||||||
|
5. [GUI Dashboard](#gui-dashboard)
|
||||||
|
6. [Architektur & Implementierung](#architektur--implementierung)
|
||||||
|
7. [API-Integration & Debugging](#api-integration--debugging)
|
||||||
|
8. [Fehlerbehandlung](#fehlerbehandlung)
|
||||||
|
9. [Projektstruktur](#projektstruktur)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Überblick
|
||||||
|
|
||||||
|
**Eugen** ist ein intelligenter Twitch-Chat-Agent für:
|
||||||
|
- **Gaming**: World of Warcraft, Elden Ring, Gamedev
|
||||||
|
- **3D-Druck**: Prusa i3, Bambu, Creality
|
||||||
|
- **Tech**: Python, Linux, Home Automation
|
||||||
|
|
||||||
|
### Kernfeatures
|
||||||
|
|
||||||
|
| Feature | Beschreibung |
|
||||||
|
|---------|-------------|
|
||||||
|
| **Name Recognition** | Erkennt automatisch wenn angesprochen (@Eugen, Eugen:, etc.) |
|
||||||
|
| **Persistent Memory** | Speichert Chat-History pro User (max 25 Nachrichten) |
|
||||||
|
| **Context-Aware** | Antwortet basierend auf vorherigem Gesprächsverlauf |
|
||||||
|
| **Perplexity Integration** | Nutzt Perplexity Sonar für Echtzeit-Web-Suche |
|
||||||
|
| **Live Monitoring** | GUI zeigt alle API-Calls, Responses, Fehler in Echtzeit |
|
||||||
|
| **Windows-Native** | Vollständige Windows-Unterstützung, keine Linux-Tools nötig |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Systemanforderungen
|
||||||
|
|
||||||
|
### Minimal
|
||||||
|
- Windows 10/11
|
||||||
|
- Python 3.9+
|
||||||
|
- 100 MB Festplatte
|
||||||
|
- Internetverbindung
|
||||||
|
|
||||||
|
### Empfohlen
|
||||||
|
- Python 3.11+
|
||||||
|
- 500 MB Festplatte (für Chat-History & Logs)
|
||||||
|
- Stabiles Netzwerk (für IRC & API)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Installation & Setup
|
||||||
|
|
||||||
|
### Schritt 1: Python installieren
|
||||||
|
|
||||||
|
1. Gehe zu [python.org](https://www.python.org/downloads/)
|
||||||
|
2. Lade **Python 3.11+** herunter
|
||||||
|
3. **WICHTIG**: Häkchen setzen bei "Add Python to PATH"
|
||||||
|
4. Installieren
|
||||||
|
|
||||||
|
**Verifizieren:**
|
||||||
|
```powershell
|
||||||
|
python --version
|
||||||
|
pip --version
|
||||||
|
```
|
||||||
|
|
||||||
|
### Schritt 2: Projekt initialisieren
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Neuer Ordner für Eugen
|
||||||
|
mkdir C:\Users\YourUsername\eugen
|
||||||
|
cd C:\Users\YourUsername\eugen
|
||||||
|
|
||||||
|
# Virtual Environment erstellen
|
||||||
|
python -m venv venv
|
||||||
|
|
||||||
|
# Aktivieren (Windows PowerShell)
|
||||||
|
.\venv\Scripts\Activate.ps1
|
||||||
|
|
||||||
|
# Falls Fehler bei Ausführungsrichtlinie:
|
||||||
|
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||||
|
# Dann nochmal: .\venv\Scripts\Activate.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
### Schritt 3: Dependencies installieren
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
**requirements.txt:**
|
||||||
|
```
|
||||||
|
perplexity-python-client==1.0.0
|
||||||
|
irc==20.1.0
|
||||||
|
python-dotenv==1.0.0
|
||||||
|
PySimpleGUI==4.60.0
|
||||||
|
requests==2.31.0
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Konfigurationsassistent
|
||||||
|
|
||||||
|
### Setup-Flow (Automatisch beim ersten Start)
|
||||||
|
|
||||||
|
Beim ersten Start wird ein **interaktives Setup-Fenster** angezeigt:
|
||||||
|
|
||||||
|
```
|
||||||
|
╔════════════════════════════════════════════════════════════════╗
|
||||||
|
║ EUGEN KONFIGURATIONSASSISTENT ║
|
||||||
|
╠════════════════════════════════════════════════════════════════╣
|
||||||
|
║ ║
|
||||||
|
║ 1️⃣ TWITCH KONFIGURATION ║
|
||||||
|
║ ─────────────────────────────────────────────────────────── ║
|
||||||
|
║ Bot-Name: [___________________________] ║
|
||||||
|
║ OAuth Token: [***hidden***] [🔑 Anleitung] ║
|
||||||
|
║ Channel: [___________________________] ║
|
||||||
|
║ ║
|
||||||
|
║ 2️⃣ PERPLEXITY KONFIGURATION ║
|
||||||
|
║ ─────────────────────────────────────────────────────────── ║
|
||||||
|
║ API Key: [***hidden***] [🔑 Anleitung] ║
|
||||||
|
║ Model: [sonar-pro ▼] ║
|
||||||
|
║ Max Tokens: [450] ║
|
||||||
|
║ ║
|
||||||
|
║ 3️⃣ BOT-VERHALTEN ║
|
||||||
|
║ ─────────────────────────────────────────────────────────── ║
|
||||||
|
║ ☑ Context Memory aktivieren ║
|
||||||
|
║ ☑ Name Recognition aktivieren ║
|
||||||
|
║ ☑ Debug-Mode (zeigt API-Calls) ║
|
||||||
|
║ ║
|
||||||
|
║ [Speichern & Starten] [Abbrechen] ║
|
||||||
|
║ ║
|
||||||
|
╚════════════════════════════════════════════════════════════════╝
|
||||||
|
```
|
||||||
|
|
||||||
|
### API-Keys beschaffen
|
||||||
|
|
||||||
|
#### Twitch OAuth Token
|
||||||
|
|
||||||
|
1. Gehe zu [twitchtokengenerator.com](https://twitchtokengenerator.com/) **ODER** manuell:
|
||||||
|
- [Twitch Developer Console](https://dev.twitch.tv/console/apps)
|
||||||
|
- Neue Anwendung erstellen
|
||||||
|
- OAuth-Authentifizierung
|
||||||
|
- Scopes: `chat:read`, `chat:edit`
|
||||||
|
- Token generieren
|
||||||
|
|
||||||
|
2. **Token Format:** `oauth:abcd1234efgh5678...`
|
||||||
|
3. **Speichern in Setup-Fenster**
|
||||||
|
|
||||||
|
**⚠️ WICHTIG:** Token niemals ins Repository committen!
|
||||||
|
|
||||||
|
#### Perplexity API Key
|
||||||
|
|
||||||
|
1. Gehe zu [perplexity.ai/api](https://www.perplexity.ai/api)
|
||||||
|
2. Registrieren / Anmelden
|
||||||
|
3. API Keys → Neuen Key generieren
|
||||||
|
4. **Format:** `pplx-abcd1234efgh5678...`
|
||||||
|
5. **Speichern in Setup-Fenster**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## GUI Dashboard
|
||||||
|
|
||||||
|
### Live Monitoring Interface
|
||||||
|
|
||||||
|
Während der Bot läuft, zeigt das Dashboard in Echtzeit:
|
||||||
|
|
||||||
|
```
|
||||||
|
╔════════════════════════════════════════════════════════════════════╗
|
||||||
|
║ EUGEN BOT - LIVE DASHBOARD ║
|
||||||
|
╠════════════════════════════════════════════════════════════════════╣
|
||||||
|
║ ║
|
||||||
|
║ STATUS: 🟢 VERBUNDEN (Kanal: #dein_kanal) ║
|
||||||
|
║ Uptime: 00:45:23 | Messages: 12 | Errors: 0 ║
|
||||||
|
║ ║
|
||||||
|
║ ┌────────────────────────────────────────────────────────────┐ ║
|
||||||
|
║ │ LIVE CHAT AKTIVITÄT │ ║
|
||||||
|
║ ├────────────────────────────────────────────────────────────┤ ║
|
||||||
|
║ │ 12:02:15 | User123: Eugen, was ist dein Lieblings-Game? │ ║
|
||||||
|
║ │ 12:02:16 | [API] → Perplexity (sonar-pro) │ ║
|
||||||
|
║ │ 12:02:18 | [RESPONSE] Mein Lieblings-Game ist WoW... │ ║
|
||||||
|
║ │ 12:02:19 | Eugen: @User123 Mein Lieblings-Game ist WoW... │ ║
|
||||||
|
║ │ │ ║
|
||||||
|
║ │ 12:03:05 | User456: Eugen, wie levelt man schnell? │ ║
|
||||||
|
║ │ 12:03:06 | [CONTEXT] Gefundener History (3 msgs) │ ║
|
||||||
|
║ │ 12:03:06 | [API] → Perplexity (sonar-pro) │ ║
|
||||||
|
║ │ 12:03:08 | [RESPONSE] Die besten Leveling-Spots sind... │ ║
|
||||||
|
║ │ 12:03:09 | Eugen: @User456 Die besten Leveling-Spots... │ ║
|
||||||
|
║ └────────────────────────────────────────────────────────────┘ ║
|
||||||
|
║ ║
|
||||||
|
║ ┌─────────────────────┬─────────────────────────────────────┐ ║
|
||||||
|
║ │ API STATISTIKEN │ FEHLER LOG │ ║
|
||||||
|
║ ├─────────────────────┼─────────────────────────────────────┤ ║
|
||||||
|
║ │ Requests: 12 │ (Leer - alles OK!) │ ║
|
||||||
|
║ │ Avg Response: 620ms │ │ ║
|
||||||
|
║ │ Costs: $0.0036 │ │ ║
|
||||||
|
║ │ Erfolgsrate: 100% │ │ ║
|
||||||
|
║ └─────────────────────┴─────────────────────────────────────┘ ║
|
||||||
|
║ ║
|
||||||
|
║ [Settings] [Clear Logs] [Export Data] [Stop Bot] ║
|
||||||
|
║ ║
|
||||||
|
╚════════════════════════════════════════════════════════════════════╝
|
||||||
|
```
|
||||||
|
|
||||||
|
### Dashboard-Tabs
|
||||||
|
|
||||||
|
#### 1. **Live Feed**
|
||||||
|
Zeigt Echtzeit-Aktivität:
|
||||||
|
- Chat-Messages
|
||||||
|
- API-Calls (Prompt → Perplexity)
|
||||||
|
- Responses von der KI
|
||||||
|
- Fehler & Warnungen
|
||||||
|
|
||||||
|
#### 2. **API Debug**
|
||||||
|
Detaillierte API-Logs mit:
|
||||||
|
```
|
||||||
|
[12:02:16] REQUEST SENT
|
||||||
|
├─ Endpoint: chat.completions
|
||||||
|
├─ Model: sonar-pro
|
||||||
|
├─ Messages: 4
|
||||||
|
├─ Prompt: "was ist dein Lieblings-Game?"
|
||||||
|
├─ Max Tokens: 450
|
||||||
|
├─ Temperature: 0.7
|
||||||
|
└─ Timestamp: 2026-01-02 12:02:16
|
||||||
|
|
||||||
|
[12:02:18] RESPONSE RECEIVED
|
||||||
|
├─ Status: 200 OK
|
||||||
|
├─ Tokens Used: 127
|
||||||
|
├─ Response: "Mein Lieblings-Game ist WoW wegen..."
|
||||||
|
├─ Processing Time: 1.834s
|
||||||
|
└─ Cost: $0.0003
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. **User Statistics**
|
||||||
|
- Nutzer mit den meisten Interaktionen
|
||||||
|
- Top-Topics (Gaming, 3D-Druck, Tech)
|
||||||
|
- Chat-History pro User anschauen
|
||||||
|
- Context-Memory Status
|
||||||
|
|
||||||
|
#### 4. **Settings**
|
||||||
|
- API-Keys ändern
|
||||||
|
- Model auswählen
|
||||||
|
- Max Tokens anpassen
|
||||||
|
- Debug-Mode togglen
|
||||||
|
- Auto-Reconnect konfigurieren
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Architektur & Implementierung
|
||||||
|
|
||||||
|
### Dateisystem
|
||||||
|
|
||||||
|
```
|
||||||
|
C:\Users\YourUsername\eugen\
|
||||||
|
├── chatbot.py # Hauptprogramm
|
||||||
|
├── config.py # Config-Management
|
||||||
|
├── gui.py # Dashboard GUI
|
||||||
|
├── ai_provider.py # Perplexity Integration
|
||||||
|
├── memory.py # Conversation Memory
|
||||||
|
├── utils.py # Hilfsfunktionen
|
||||||
|
├── requirements.txt # Dependencies
|
||||||
|
├── .env # Secrets (NICHT committen!)
|
||||||
|
│
|
||||||
|
├── data/
|
||||||
|
│ ├── conversations/ # User Chat-Histories
|
||||||
|
│ │ ├── user1.json
|
||||||
|
│ │ ├── user2.json
|
||||||
|
│ │ └── ...
|
||||||
|
│ └── config.json # Gespeicherte Konfiguration
|
||||||
|
│
|
||||||
|
└── logs/
|
||||||
|
├── eugen.log # Hauptlogfile
|
||||||
|
└── api_debug.log # API Debug-Logs
|
||||||
|
```
|
||||||
|
|
||||||
|
### Kernklassen
|
||||||
|
|
||||||
|
#### `MentionDetector`
|
||||||
|
```python
|
||||||
|
class MentionDetector:
|
||||||
|
"""Erkennt ob Bot angesprochen wurde"""
|
||||||
|
|
||||||
|
def is_mentioned(self, message: str) -> bool:
|
||||||
|
"""True wenn @Eugen, Eugen:, eugen, etc. erwähnt"""
|
||||||
|
|
||||||
|
def extract_content(self, message: str) -> str:
|
||||||
|
"""Extrahiert Nachricht ohne Mention"""
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `ConversationMemory`
|
||||||
|
```python
|
||||||
|
class ConversationMemory:
|
||||||
|
"""Speichert & lädt Chat-History pro User"""
|
||||||
|
|
||||||
|
def get_user_history(self, username: str) -> list:
|
||||||
|
"""Letzte 5 Messages für Context"""
|
||||||
|
|
||||||
|
def add_message(self, username: str, role: str, content: str):
|
||||||
|
"""Speichert Message (user/assistant)"""
|
||||||
|
|
||||||
|
def format_for_prompt(self, history: list) -> str:
|
||||||
|
"""Konvertiert zu Prompt-Format"""
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `PerplexityProvider`
|
||||||
|
```python
|
||||||
|
class PerplexityProvider:
|
||||||
|
"""Kommunikiert mit Perplexity API"""
|
||||||
|
|
||||||
|
async def get_response(self, prompt: str, history: list) -> str:
|
||||||
|
"""Sendet Prompt + History, empfängt Response"""
|
||||||
|
|
||||||
|
def validate_api_key(self, key: str) -> bool:
|
||||||
|
"""Prüft ob API-Key gültig ist"""
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `EugenBot` (Main)
|
||||||
|
```python
|
||||||
|
class EugenBot:
|
||||||
|
"""Orchestriert alles: IRC, Memory, AI, GUI"""
|
||||||
|
|
||||||
|
async def on_chat_message(self, username: str, message: str):
|
||||||
|
"""Wird aufgerufen wenn Chat-Message ankommt"""
|
||||||
|
|
||||||
|
def send_response(self, channel: str, username: str, response: str):
|
||||||
|
"""Sendet Antwort im Chat"""
|
||||||
|
|
||||||
|
def log_event(self, event_type: str, data: dict):
|
||||||
|
"""Loggt alles für Debug-Dashboard"""
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## API-Integration & Debugging
|
||||||
|
|
||||||
|
### Was passiert beim Chat?
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Chat-Message empfangen
|
||||||
|
↓
|
||||||
|
2. [MentionDetector] → Wurde Bot angesprochen?
|
||||||
|
↓ Ja
|
||||||
|
3. [ConversationMemory] → Lade letzte 5 Messages dieses Users
|
||||||
|
↓
|
||||||
|
4. [Prompt Builder]
|
||||||
|
├─ System Prompt: "Du bist Eugen, Gamer & 3D-Druck Experte"
|
||||||
|
├─ Context History: Letzte Konversation
|
||||||
|
└─ Current Message: Die neue Frage
|
||||||
|
↓
|
||||||
|
5. [API Call] → Perplexity Sonar
|
||||||
|
├─ Method: POST /chat/completions
|
||||||
|
├─ Model: sonar-pro
|
||||||
|
├─ Messages: 4 (system, history, history, user)
|
||||||
|
└─ Max Tokens: 450
|
||||||
|
↓
|
||||||
|
6. [Perplexity Processing] ~600-1000ms
|
||||||
|
↓
|
||||||
|
7. [Response] → KI-Antwort (z.B. "Mein Lieblings-Game ist WoW...")
|
||||||
|
↓
|
||||||
|
8. [ConversationMemory] → Speichere in user.json
|
||||||
|
↓
|
||||||
|
9. [IRC Send] → Sende im Chat: "@Username KI-Antwort"
|
||||||
|
↓
|
||||||
|
10. [Dashboard Update] → Zeige alles in Live-Feed
|
||||||
|
```
|
||||||
|
|
||||||
|
### Debug-Mode aktivieren
|
||||||
|
|
||||||
|
In der GUI oder `.env`:
|
||||||
|
```
|
||||||
|
DEBUG_MODE=true
|
||||||
|
```
|
||||||
|
|
||||||
|
Dann wird in der CLI ausgegeben:
|
||||||
|
```
|
||||||
|
[DEBUG] 12:02:16 - Message received from User123
|
||||||
|
[DEBUG] 12:02:16 - Mention detected: @Eugen
|
||||||
|
[DEBUG] 12:02:16 - Content extracted: "was ist dein Lieblings-Game?"
|
||||||
|
[DEBUG] 12:02:16 - History loaded: 3 messages
|
||||||
|
[DEBUG] 12:02:16 - Building prompt...
|
||||||
|
[DEBUG] 12:02:16 - SYSTEM: "Du bist Eugen..."
|
||||||
|
[DEBUG] 12:02:16 - HISTORY[0]: User: "Wie geht es dir?"
|
||||||
|
[DEBUG] 12:02:16 - HISTORY[1]: Assistant: "Mir geht's gut!"
|
||||||
|
[DEBUG] 12:02:16 - HISTORY[2]: User: "Spielst du WoW?"
|
||||||
|
[DEBUG] 12:02:16 - CURRENT: "was ist dein Lieblings-Game?"
|
||||||
|
[DEBUG] 12:02:16 - Sending to Perplexity API...
|
||||||
|
[DEBUG] 12:02:16 - REQUEST: {"model": "sonar-pro", "messages": [...], ...}
|
||||||
|
[DEBUG] 12:02:18 - RESPONSE: 200 OK
|
||||||
|
[DEBUG] 12:02:18 - Content: "Mein Lieblings-Game ist WoW..."
|
||||||
|
[DEBUG] 12:02:18 - Tokens used: 127 (cost: $0.0003)
|
||||||
|
[DEBUG] 12:02:18 - Saving to memory...
|
||||||
|
[DEBUG] 12:02:18 - Sending IRC: "@User123 Mein Lieblings-Game ist WoW..."
|
||||||
|
[DEBUG] 12:02:19 - Message sent successfully
|
||||||
|
```
|
||||||
|
|
||||||
|
### API-Keys validieren
|
||||||
|
|
||||||
|
Setup-Fenster prüft automatisch:
|
||||||
|
|
||||||
|
```python
|
||||||
|
# Twitch Token
|
||||||
|
def validate_twitch_token(token: str) -> bool:
|
||||||
|
"""Test mit Twitch IRC Connection"""
|
||||||
|
try:
|
||||||
|
irc.client.IRC().connect(
|
||||||
|
"irc.chat.twitch.tv", 6667,
|
||||||
|
nickname, token=token
|
||||||
|
)
|
||||||
|
return True
|
||||||
|
except:
|
||||||
|
return False
|
||||||
|
|
||||||
|
# Perplexity API Key
|
||||||
|
def validate_perplexity_key(key: str) -> bool:
|
||||||
|
"""Test mit einfachem API Call"""
|
||||||
|
try:
|
||||||
|
response = requests.post(
|
||||||
|
"https://api.perplexity.ai/chat/completions",
|
||||||
|
headers={"Authorization": f"Bearer {key}"},
|
||||||
|
json={
|
||||||
|
"model": "sonar-pro",
|
||||||
|
"messages": [{"role": "user", "content": "test"}],
|
||||||
|
"max_tokens": 10
|
||||||
|
},
|
||||||
|
timeout=5
|
||||||
|
)
|
||||||
|
return response.status_code == 200
|
||||||
|
except:
|
||||||
|
return False
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Fehlerbehandlung
|
||||||
|
|
||||||
|
### Häufige Fehler & Lösungen
|
||||||
|
|
||||||
|
#### 1. **"Invalid Twitch Token"**
|
||||||
|
```
|
||||||
|
Fehler: Setup schlägt fehl
|
||||||
|
Grund: Token abgelaufen oder falsch
|
||||||
|
|
||||||
|
Lösung:
|
||||||
|
1. Gehe zu twitchtokengenerator.com
|
||||||
|
2. Generiere neuen Token
|
||||||
|
3. Kopiere: oauth:... (mit oauth: Prefix!)
|
||||||
|
4. Paste in Setup-Fenster
|
||||||
|
5. Validierung sollte grün werden
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. **"Perplexity API Error 401"**
|
||||||
|
```
|
||||||
|
Fehler: Bot startet, aber keine Responses
|
||||||
|
Grund: Ungültiger API-Key oder Account-Issue
|
||||||
|
|
||||||
|
Lösung:
|
||||||
|
1. Prüfe API-Key auf perplexity.ai
|
||||||
|
2. Stelle sicher Account hat Credits (kostenlos gibt es $5/Monat)
|
||||||
|
3. Copy-paste genau (ohne Spaces)
|
||||||
|
4. Teste mit Setup-Validierung
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. **"Cannot connect to Twitch IRC"**
|
||||||
|
```
|
||||||
|
Fehler: Bot startet nicht
|
||||||
|
Grund: Netzwerk oder Twitch offline
|
||||||
|
|
||||||
|
Lösung:
|
||||||
|
1. Prüfe Internet-Verbindung
|
||||||
|
2. Teste: ping irc.chat.twitch.tv
|
||||||
|
3. Firewall-Regel für Python hinzufügen
|
||||||
|
4. Auto-Reconnect wartet 10 Sekunden, versucht erneut
|
||||||
|
5. Dashboard zeigt Reconnect-Versuche
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. **"Memory File Corrupted"**
|
||||||
|
```
|
||||||
|
Fehler: Chat-History wird nicht geladen
|
||||||
|
Grund: JSON-Datei beschädigt
|
||||||
|
|
||||||
|
Lösung:
|
||||||
|
1. Dashboard → Settings → "Reset Memory"
|
||||||
|
2. Oder manuell: Lösche data/conversations/username.json
|
||||||
|
3. Nächster Chat-Start erstellt neue Datei
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5. **"Response Rate Limited"**
|
||||||
|
```
|
||||||
|
Fehler: Lange Wartezeiten, Timeout
|
||||||
|
Grund: Zu viele API-Calls zu schnell
|
||||||
|
|
||||||
|
Lösung:
|
||||||
|
1. Perplexity hat Rate-Limit pro Account
|
||||||
|
2. Warte 1-2 Sekunden zwischen Messages
|
||||||
|
3. Dashboard zeigt "Rate Limit - Waiting..."
|
||||||
|
4. Nach 60 Sekunden Auto-Retry
|
||||||
|
```
|
||||||
|
|
||||||
|
### Error Dashboard
|
||||||
|
|
||||||
|
Alle Fehler werden im Dashboard gesammelt:
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ FEHLER (LETZTE 24H) │
|
||||||
|
├─────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ ❌ 12:05:22 | Perplexity Timeout │
|
||||||
|
│ Message von User123 │
|
||||||
|
│ → Auto-Retry in 10 Sekunden │
|
||||||
|
│ │
|
||||||
|
│ ❌ 11:45:15 | API Rate Limited │
|
||||||
|
│ 10 Requests in 5 Sekunden │
|
||||||
|
│ → Auto-Wait aktiviert │
|
||||||
|
│ │
|
||||||
|
│ [Clear Errors] [Export Report] │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Projektstruktur
|
||||||
|
|
||||||
|
### Wichtigste Dateien für Programmiere r
|
||||||
|
|
||||||
|
#### `chatbot.py` (Hauptprogramm)
|
||||||
|
```python
|
||||||
|
import asyncio
|
||||||
|
from config import Config
|
||||||
|
from memory import ConversationMemory
|
||||||
|
from ai_provider import PerplexityProvider
|
||||||
|
from gui import Dashboard
|
||||||
|
from utils import MentionDetector, Logger
|
||||||
|
|
||||||
|
class EugenBot:
|
||||||
|
def __init__(self):
|
||||||
|
self.config = Config()
|
||||||
|
self.memory = ConversationMemory()
|
||||||
|
self.ai = PerplexityProvider(self.config.perplexity_key)
|
||||||
|
self.detector = MentionDetector()
|
||||||
|
self.logger = Logger()
|
||||||
|
self.dashboard = Dashboard(self)
|
||||||
|
|
||||||
|
async def run(self):
|
||||||
|
# IRC Connection
|
||||||
|
# Listen for messages
|
||||||
|
# Process & respond
|
||||||
|
# Update dashboard
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `config.py` (Konfiguration)
|
||||||
|
```python
|
||||||
|
import os
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
from dotenv import load_dotenv
|
||||||
|
|
||||||
|
class Config:
|
||||||
|
def __init__(self):
|
||||||
|
load_dotenv()
|
||||||
|
|
||||||
|
self.twitch_token = os.getenv("TWITCH_OAUTH_TOKEN")
|
||||||
|
self.twitch_channel = os.getenv("TWITCH_CHANNEL")
|
||||||
|
self.bot_name = os.getenv("TWITCH_BOT_NICKNAME", "Eugen")
|
||||||
|
|
||||||
|
self.perplexity_key = os.getenv("PERPLEXITY_API_KEY")
|
||||||
|
self.model = os.getenv("PERPLEXITY_MODEL", "sonar-pro")
|
||||||
|
self.max_tokens = int(os.getenv("MAX_TOKENS", "450"))
|
||||||
|
|
||||||
|
self.debug_mode = os.getenv("DEBUG_MODE", "false").lower() == "true"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `ai_provider.py` (Perplexity API)
|
||||||
|
```python
|
||||||
|
import httpx
|
||||||
|
import json
|
||||||
|
from typing import List, Dict
|
||||||
|
|
||||||
|
class PerplexityProvider:
|
||||||
|
def __init__(self, api_key: str):
|
||||||
|
self.api_key = api_key
|
||||||
|
self.base_url = "https://api.perplexity.ai"
|
||||||
|
self.model = "sonar-pro"
|
||||||
|
|
||||||
|
async def get_response(self, messages: List[Dict]) -> str:
|
||||||
|
"""
|
||||||
|
Sendet Messages zu Perplexity, erhält Response
|
||||||
|
|
||||||
|
Args:
|
||||||
|
messages: [
|
||||||
|
{"role": "system", "content": "..."},
|
||||||
|
{"role": "user", "content": "..."},
|
||||||
|
...
|
||||||
|
]
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
Response-Text von der KI
|
||||||
|
"""
|
||||||
|
headers = {
|
||||||
|
"Authorization": f"Bearer {self.api_key}",
|
||||||
|
"Content-Type": "application/json"
|
||||||
|
}
|
||||||
|
|
||||||
|
payload = {
|
||||||
|
"model": self.model,
|
||||||
|
"messages": messages,
|
||||||
|
"max_tokens": 450,
|
||||||
|
"temperature": 0.7
|
||||||
|
}
|
||||||
|
|
||||||
|
async with httpx.AsyncClient() as client:
|
||||||
|
response = await client.post(
|
||||||
|
f"{self.base_url}/chat/completions",
|
||||||
|
json=payload,
|
||||||
|
headers=headers,
|
||||||
|
timeout=30
|
||||||
|
)
|
||||||
|
|
||||||
|
if response.status_code == 200:
|
||||||
|
data = response.json()
|
||||||
|
return data['choices'][0]['message']['content']
|
||||||
|
else:
|
||||||
|
raise Exception(f"API Error {response.status_code}: {response.text}")
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `memory.py` (Chat-Speicher)
|
||||||
|
```python
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
from datetime import datetime, timedelta
|
||||||
|
from typing import List, Dict
|
||||||
|
|
||||||
|
class ConversationMemory:
|
||||||
|
def __init__(self, max_messages=25, data_dir="data/conversations"):
|
||||||
|
self.data_dir = Path(data_dir)
|
||||||
|
self.data_dir.mkdir(parents=True, exist_ok=True)
|
||||||
|
self.max_messages = max_messages
|
||||||
|
|
||||||
|
def get_user_history(self, username: str, limit: int = 5) -> List[Dict]:
|
||||||
|
"""Lädt letzte Chat-Messages für User"""
|
||||||
|
file_path = self.data_dir / f"{username.lower()}.json"
|
||||||
|
|
||||||
|
if not file_path.exists():
|
||||||
|
return []
|
||||||
|
|
||||||
|
with open(file_path, 'r', encoding='utf-8') as f:
|
||||||
|
history = json.load(f)
|
||||||
|
|
||||||
|
# Nur Messages der letzten 1 Stunde
|
||||||
|
cutoff_time = datetime.now() - timedelta(hours=1)
|
||||||
|
recent = [
|
||||||
|
msg for msg in history[-limit:]
|
||||||
|
if datetime.fromisoformat(msg['timestamp']) > cutoff_time
|
||||||
|
]
|
||||||
|
|
||||||
|
return recent
|
||||||
|
|
||||||
|
def add_message(self, username: str, role: str, content: str):
|
||||||
|
"""Speichert eine Message (role: 'user' oder 'assistant')"""
|
||||||
|
file_path = self.data_dir / f"{username.lower()}.json"
|
||||||
|
|
||||||
|
history = []
|
||||||
|
if file_path.exists():
|
||||||
|
with open(file_path, 'r', encoding='utf-8') as f:
|
||||||
|
history = json.load(f)
|
||||||
|
|
||||||
|
history.append({
|
||||||
|
"role": role,
|
||||||
|
"content": content,
|
||||||
|
"timestamp": datetime.now().isoformat()
|
||||||
|
})
|
||||||
|
|
||||||
|
# Max Nachrichten-Limit einhalten
|
||||||
|
history = history[-self.max_messages:]
|
||||||
|
|
||||||
|
with open(file_path, 'w', encoding='utf-8') as f:
|
||||||
|
json.dump(history, f, ensure_ascii=False, indent=2)
|
||||||
|
|
||||||
|
def format_for_prompt(self, history: List[Dict]) -> List[Dict]:
|
||||||
|
"""Konvertiert History zu Message-Format für AI-API"""
|
||||||
|
return [
|
||||||
|
{
|
||||||
|
"role": msg['role'],
|
||||||
|
"content": msg['content']
|
||||||
|
}
|
||||||
|
for msg in history
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `gui.py` (Dashboard)
|
||||||
|
```python
|
||||||
|
import PySimpleGUI as sg
|
||||||
|
import threading
|
||||||
|
from datetime import datetime
|
||||||
|
|
||||||
|
class Dashboard:
|
||||||
|
def __init__(self, bot):
|
||||||
|
self.bot = bot
|
||||||
|
sg.theme('DarkBlue3')
|
||||||
|
|
||||||
|
# Event-Queue für Thread-Safe Updates
|
||||||
|
self.event_queue = []
|
||||||
|
|
||||||
|
def log_event(self, event_type: str, data: Dict):
|
||||||
|
"""Protokolliert Event für Dashboard"""
|
||||||
|
timestamp = datetime.now().strftime("%H:%M:%S")
|
||||||
|
|
||||||
|
if event_type == "chat_message":
|
||||||
|
msg = f"{timestamp} | {data['username']}: {data['content']}"
|
||||||
|
elif event_type == "api_call":
|
||||||
|
msg = f"{timestamp} | [API] → {data['model']}"
|
||||||
|
elif event_type == "api_response":
|
||||||
|
msg = f"{timestamp} | [RESPONSE] {data['content'][:50]}..."
|
||||||
|
elif event_type == "error":
|
||||||
|
msg = f"{timestamp} | ❌ {data['error']}"
|
||||||
|
|
||||||
|
self.event_queue.append(msg)
|
||||||
|
|
||||||
|
def render(self):
|
||||||
|
"""Rendet GUI-Fenster"""
|
||||||
|
layout = [
|
||||||
|
[sg.Text("EUGEN BOT - LIVE DASHBOARD", font=("Arial", 16, "bold"))],
|
||||||
|
[sg.Text(f"Status: 🟢 VERBUNDEN", key="-STATUS-")],
|
||||||
|
[sg.Multiline(
|
||||||
|
size=(120, 30),
|
||||||
|
key="-LOG-",
|
||||||
|
disabled=True,
|
||||||
|
autoscroll=True
|
||||||
|
)],
|
||||||
|
[sg.Button("Settings"), sg.Button("Clear"), sg.Button("Stop")]
|
||||||
|
]
|
||||||
|
|
||||||
|
window = sg.Window("Eugen Bot", layout)
|
||||||
|
|
||||||
|
while True:
|
||||||
|
event, values = window.read(timeout=100)
|
||||||
|
|
||||||
|
# Update Log
|
||||||
|
if self.event_queue:
|
||||||
|
for msg in self.event_queue:
|
||||||
|
window["-LOG-"].print(msg)
|
||||||
|
self.event_queue = []
|
||||||
|
|
||||||
|
if event == sg.WINDOW_CLOSED or event == "Stop":
|
||||||
|
break
|
||||||
|
|
||||||
|
window.close()
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `.env` (Secrets)
|
||||||
|
```
|
||||||
|
# Twitch Configuration
|
||||||
|
TWITCH_OAUTH_TOKEN=oauth:xxxxxxxxxxxxx
|
||||||
|
TWITCH_BOT_NICKNAME=Eugen
|
||||||
|
TWITCH_CHANNEL=#dein_kanal
|
||||||
|
|
||||||
|
# Perplexity Configuration
|
||||||
|
PERPLEXITY_API_KEY=pplx-xxxxxxxxxxxxx
|
||||||
|
PERPLEXITY_MODEL=sonar-pro
|
||||||
|
MAX_TOKENS=450
|
||||||
|
|
||||||
|
# Bot Configuration
|
||||||
|
DEBUG_MODE=true
|
||||||
|
AUTO_RECONNECT=true
|
||||||
|
RECONNECT_DELAY=10
|
||||||
|
|
||||||
|
# Data Configuration
|
||||||
|
DATA_DIR=data/conversations
|
||||||
|
LOG_DIR=logs
|
||||||
|
CONTEXT_RETENTION_HOURS=1
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Start für Windows
|
||||||
|
|
||||||
|
### Installation (5 Minuten)
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# 1. Python installiert? Wenn nicht: python.org
|
||||||
|
python --version
|
||||||
|
|
||||||
|
# 2. Projekt clonen/downlaoden
|
||||||
|
cd C:\Users\YourUsername\eugen
|
||||||
|
|
||||||
|
# 3. Virtual Environment
|
||||||
|
python -m venv venv
|
||||||
|
.\venv\Scripts\Activate.ps1
|
||||||
|
|
||||||
|
# 4. Dependencies
|
||||||
|
pip install -r requirements.txt
|
||||||
|
|
||||||
|
# 5. Konfigurieren
|
||||||
|
python chatbot.py
|
||||||
|
# → Setup-Fenster öffnet sich
|
||||||
|
# → API-Keys eingeben
|
||||||
|
# → Validierung läuft
|
||||||
|
# → Speichern & Starten
|
||||||
|
|
||||||
|
# 6. Dashboard öffnet sich mit Live-Feed
|
||||||
|
```
|
||||||
|
|
||||||
|
### Fehlersuche
|
||||||
|
|
||||||
|
**Problem: Module nicht gefunden?**
|
||||||
|
```powershell
|
||||||
|
# Sicherstellen dass venv aktiviert ist:
|
||||||
|
.\venv\Scripts\Activate.ps1
|
||||||
|
|
||||||
|
# Dann reinstallieren:
|
||||||
|
pip install --upgrade pip
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
**Problem: Port 6667 blocked?**
|
||||||
|
```powershell
|
||||||
|
# Firewall-Exception für Python:
|
||||||
|
# Windows Defender → "Firewall & Netzwerkschutz"
|
||||||
|
# → "App durch Firewall zulassen"
|
||||||
|
# → Python hinzufügen
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Verbesserungen & Erweiterungen
|
||||||
|
|
||||||
|
### Einfache Adds (für später)
|
||||||
|
|
||||||
|
- [ ] Multi-Channel Support (mehrere Kanäle gleichzeitig)
|
||||||
|
- [ ] Custom Commands (!gaming, !3dprint)
|
||||||
|
- [ ] User-Blacklist (bestimmte User ignorieren)
|
||||||
|
- [ ] Response-Timeout (wenn API zu langsam)
|
||||||
|
- [ ] Discord Webhook (errori an Discord schicken)
|
||||||
|
- [ ] Analytics Export (CSV mit Stats)
|
||||||
|
|
||||||
|
### Für Programmiere r: Custom Features
|
||||||
|
|
||||||
|
Neue Commands hinzufügen:
|
||||||
|
```python
|
||||||
|
class CommandHandler:
|
||||||
|
def handle_command(self, cmd: str, args: str) -> str:
|
||||||
|
if cmd == "gaming":
|
||||||
|
return "Tipps für WoW, Elden Ring..."
|
||||||
|
elif cmd == "3dprint":
|
||||||
|
return "3D-Druck Hilfe..."
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Support & Debugging
|
||||||
|
|
||||||
|
Bei Fehlern:
|
||||||
|
|
||||||
|
1. **Prüfe Dashboard** → "Fehler" Tab
|
||||||
|
2. **Debug-Mode aktivieren** → `.env` → `DEBUG_MODE=true`
|
||||||
|
3. **Logs anschauen** → `logs/eugen.log`
|
||||||
|
4. **API Key validieren** → Setup-Fenster erneut öffnen
|
||||||
|
5. **Internet prüfen** → ping google.com
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
92
gitignore
Normal file
92
gitignore
Normal file
|
|
@ -0,0 +1,92 @@
|
||||||
|
# Python Virtual Environment
|
||||||
|
venv/
|
||||||
|
env/
|
||||||
|
ENV/
|
||||||
|
.venv
|
||||||
|
|
||||||
|
# Python Cache
|
||||||
|
__pycache__/
|
||||||
|
*.py[cod]
|
||||||
|
*$py.class
|
||||||
|
*.so
|
||||||
|
.Python
|
||||||
|
build/
|
||||||
|
develop-eggs/
|
||||||
|
dist/
|
||||||
|
downloads/
|
||||||
|
eggs/
|
||||||
|
.eggs/
|
||||||
|
lib/
|
||||||
|
lib64/
|
||||||
|
parts/
|
||||||
|
sdist/
|
||||||
|
var/
|
||||||
|
wheels/
|
||||||
|
pip-wheel-metadata/
|
||||||
|
share/python-wheels/
|
||||||
|
*.egg-info/
|
||||||
|
.installed.cfg
|
||||||
|
*.egg
|
||||||
|
MANIFEST
|
||||||
|
|
||||||
|
# IDE & Editor
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
*~
|
||||||
|
.DS_Store
|
||||||
|
*.sublime-project
|
||||||
|
*.sublime-workspace
|
||||||
|
.project
|
||||||
|
.pydevproject
|
||||||
|
.settings/
|
||||||
|
|
||||||
|
# Environment Variables (SECRETS!)
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.*.local
|
||||||
|
*.key
|
||||||
|
*.pem
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
logs/
|
||||||
|
*.log
|
||||||
|
*.log.*
|
||||||
|
eugen.log
|
||||||
|
api_debug.log
|
||||||
|
|
||||||
|
# OS specific
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
|
Desktop.ini
|
||||||
|
.AppleDouble
|
||||||
|
.LSOverride
|
||||||
|
|
||||||
|
# Testing
|
||||||
|
.pytest_cache/
|
||||||
|
.coverage
|
||||||
|
htmlcov/
|
||||||
|
.tox/
|
||||||
|
.hypothesis/
|
||||||
|
|
||||||
|
# IDE Temp Files
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.iml
|
||||||
|
|
||||||
|
# Chat History (optional - keep für Backup, aber nicht unbedingt committen)
|
||||||
|
# Wenn ihr die History NICHT committen wollt, uncomment:
|
||||||
|
# data/conversations/
|
||||||
|
# data/config.json
|
||||||
|
|
||||||
|
# Temporary Files
|
||||||
|
*.tmp
|
||||||
|
*.temp
|
||||||
|
*~
|
||||||
|
.~lock.*
|
||||||
|
|
||||||
|
# OS Specific
|
||||||
|
.Spotlight-V100
|
||||||
|
.Trashes
|
||||||
|
ehthumbs.db
|
||||||
Loading…
Add table
Add a link
Reference in a new issue