Helios

Eigenständiger Twitch-Bot mit Browser-Dashboard — lokal, ohne externe Dienste

v0.3a
Helios läuft vollständig lokal. Kein Cloud-Zwang, keine externen Services — einmal Helios.exe ausführen, Browser öffnet sich automatisch, Twitch OAuth, fertig. Das gesamte Projekt steckt in einer einzigen Datei.
Python 3.12
Sprache
TwitchIO 2
Chat / IRC
FastAPI
Dashboard
SQLite
Datenbank
Fernet
Token-Sicherheit
1 Datei
Helios.exe

Features

💬 Chat & Commands

  • !ping, !uptime, !lurk, !shoutout, !commands
  • Custom Commands mit Cooldown
  • Permission-Level: everyone / sub / vip / mod / broadcaster
  • Vollständig über Dashboard verwaltbar

🛡 Moderation

  • Link-Filter mit Domain-Whitelist
  • Wort-Filter mit Leet-Speak-Erkennung
  • Caps-Filter (konfigurierbarer Schwellwert)
  • Spam-Filter (Zeichenwiederholung)
  • Aktionen: Löschen / Timeout / Ban

🔔 Events (EventSub)

  • Follow, Abo, Re-Sub, Gift-Subs
  • Raid, Bits
  • Automatische Chat-Reaktion pro Event-Typ

🖥 Dashboard & OBS

  • Erreichbar von jedem Gerät im Heimnetz
  • 3 OBS Browser-Docks: Chat, Events, Steuerung
  • IP-Anzeige (lokal + global) nur nach PIN

📋 Chat-Log

  • Optional aktivierbar
  • Format wie Chatty / IRC-Logs
  • chat_logs/YYYY-MM-DD.log

💾 Backup & Import

  • Export aller Einstellungen + Tokens als JSON
  • Import → Bot startet automatisch neu
  • Beides PIN-geschützt

Screenshots

Übersicht — Live-Chat, Events & Schnellaktionen

Übersicht — Live-Chat, Events & Schnellaktionen

Commands — Eingebaut & Custom Commands

Commands — Eingebaut & Custom Commands

Moderation — Filter, Whitelist, Wort-Filter

Moderation — Filter, Whitelist, Wort-Filter

Einstellungen — Bot-Config, OBS-Docks, IP-Anzeige

Einstellungen — Bot-Config, OBS-Docks, IP-Anzeige

Setup — Einmalige Twitch OAuth Einrichtung

Setup — Einmalige Twitch OAuth Einrichtung

Dateistruktur

Helios.exe                 ← Der gesamte Bot (eine Datei)
twitch-bot-data/
    config.json            ← Einstellungen
    tokens.enc             ← OAuth-Tokens (verschlüsselt)
    key.secret             ← Fernet-Schlüssel
    bot.db                 ← SQLite-Datenbank
    chat_logs/
        2026-04-19.log

⬇ Download

Helios v0.3a — ZIP enthält Helios.exe. Entpacken, Helios.exe starten — fertig.

⬇ Helios.zip herunterladen