Kevin – Denkender Discord-Bot mit PDF- und LaTeX-Funktionalität

Willkommen bei Kevin, Deinem AI-basierten Discord-Bot! Du kannst ihn als persönlichen Assistenten für Textfragen, PDF-Analyse und LaTeX-Rendering verwenden. Kevin nutzt die OpenAI-API und bietet so intelligente Antworten in Deinem Discord-Kanal.

---

Was macht Kevin besonders?

• Bilder und PDFs::

  • Er verarbeitet Textnachrichten, Bilder und PDFs direkt im Chat.

• LaTeX-Ausdrücke::

  • Er erkennt LaTeX-Ausdrücke und rendert sie als Bild via CodeCogs.

---

Voraussetzungen

• Python 3.12 (oder höher)
• Ein funktionierendes Discord-Bot-Token
• Ein OpenAI-API-Key
• Eine Umgebung, in der Du Python-Bibliotheken aus der requirements.txt installieren kannst

Installation

Dieses Repository klonen oder herunterladen requirements.txt installieren:

pip install -r requirements.txt

Deine Zugangsdaten (bot_token, api_key) in der config.yaml eintragen Bot starten:

python3 main.py

Funktionen im Überblick

• Chat: Kevin reagiert auf Deine Nachrichten im Kanal und in Direkt-Nachrichten.
• Bilder & Pdf's werden an OpenAI gesendet, damit du mit Kevin darüber sprechen kannst.
• LaTeX-Erkennung: Formeln wie $$a^2 + b^2 = c^2$$ oder [(a + b)^n] rendert Kevin als PNG und hängt es an die Antwort an.
• Slash Commands
  • /help: Zeigt eine kurze Übersicht aller verfügbaren Slash-Befehle.
  • /suchen : Führt eine Websuche mit GPT-5 durch, um Informationen aus dem Internet einzubeziehen.
  • /vergessen: Löscht das Wissen aus dem aktuellen Kanal.
  • /bild : Erzeugt ein Bild mit DALL-E 3 auf Basis des Prompts. Das Format kann „quadratisch“, „hoch“ oder „breit“ gewählt werden.

Nutzungshinweise

• Die PDF-Upload ist relativ neu. OpenAI hat das aktuell auf 100 Seite und 32MB begrenzt.
• LaTeX wird via CodeCogs gerendert. Beachte die Nutzungsbedingungen.
• Achte darauf, Deinen API-Key nicht versehentlich öffentlich zu machen.

Support und Beiträge

• Erstelle Pull Requests, wenn Du Ideen oder Verbesserungen hast.
• Nutze die Issues, falls Du Fehler findest.

---

Warnungen & Hinweise

Kosten / Tokenverbrauch

• GPT-5 analysiert Bilder und PDFs; das kann schnell Tokens kosten.
• DALL·E 3-Bilder kosten je nach Prompt/Ergebnis. Rate Limits
• OpenAI hat Rate Limits, Discord ebenso. Bei zu vielen Messages in kurzer Zeit kann es zu Verzögerungen kommen. Privatsphäre
• Alle hochgeladenen Dateien (Bilder/PDFs) werden kurz an OpenAI geschickt. Bedenke das, wenn es vertrauliche Infos sind. Große PDFs
• Kürzen die PDF-Auszüge auf die gewünschte Anzahl Zeichen. Bei sehr langen Dokumenten musst du ggf. manuell aufteilen. Vision-Qualität
• GPT-5 ist nicht unfehlbar (besonders bei kleinen Details, Text in Bildern, speziellen Grafiken).