ShunyaNet Sentinel (AKTUALISIERT: 03/02/2026)

ShunyaNet Sentinel ist ein leichtgewichtiges, Cyberpunk-inspiriertes Programm, das RSS-Feeds (z. B. aktuelle Nachrichten, soziale Medien) abruft, sie zur Analyse an ein LLM sendet und in regelmäßigen Abständen direkt an die GUI und an Slack Alarme und Zusammenfassungsberichte ausgibt.

Das Projekt ist darauf ausgelegt, ein lokal auf demselben Rechner oder Netzwerk (z. B. mit Tailscale) gehostetes LLM zu nutzen – entweder mit LMStudio oder Ollama (Update 23.02.). Es funktioniert auch mit einem OpenAI-API-Key (Update 23.02.).

Für die Alarmierung verwendet das Programm Slack-Webhooks, sodass Push-Benachrichtigungen an ein mobiles Gerät gesendet werden können.

Der ShunyaNet Sentinel ist mit den aktuellsten Versionen von Linux, macOS und Windows* kompatibel.

Die Qualität der Berichte und Analysen wird durch das Prompt, die Kontextgröße, die RSS-Feeds und das gewählte LLM beeinflusst. Es wird empfohlen, Thinking-Funktionen auszuschalten. Modelle, die sich in Tests bewährt haben und Anweisungen im Allgemeinen gut befolgen, sind:

• GPT OSS 20b (Thinking auf LOW in LMStudio gesetzt)
• GPT OSS 120b (wahrscheinlich übertrieben)
• Hermes 4 70b (mein Go-to)
• Gemma 3 27b abliterated (mlabonnes Version)
• Qwen3 32b und/oder VL 30b (ich vergesse, welches …)

*Starke Empfehlung: macOS oder Linux. Siehe „Bekannte Probleme“ unten.

Wichtige Informationen finden Sie am Ende unter „Tipps, Tricks und bekannte Probleme“!

Hochrangiger Arbeitsablauf

1. Benutzer gibt interessante Themen ein.
2. Benutzer stellt eine Liste von RSS-Feeds bereit.
3. Sentinel ruft RSS-Feeds in benutzerdefinierten Intervallen ab.
4. Der RSS-Inhalt wird an den angegebenen LLM-Server gesendet.
5. Das LLM durchsucht die Feeds und meldet dem Sentinel relevante Themen.
6. Wenn ein Slack-Webhook konfiguriert ist, werden Benachrichtigungen weitergeleitet und sind auf iOS/Android zugänglich (oft mit Live-Links zu den referenzierten RSS-Inhalten).
7. Die optionale Stapelanalyse identifiziert Trends über einen Zeitraum.

Kernfunktionen

RSS-Feed-Überwachung

• Regelmäßiges Abrufen von RSS-Feeds
• Deduplizierung und Zeitstempel-Verfolgung
• Verarbeitung langsamer oder fehlerhafter Feeds (… hier ist noch Arbeit nötig)

LLM-basierte Analyse (optional)

• Sendet RSS-Feed-Elemente an einen lokalen/API-LLM-Endpunkt
• Prompt-gesteuerte Klassifizierung, Zusammenfassung, Filterung
• Funktioniert mit jedem OpenAI-kompatiblen /v1/chat/completions-Endpunkt – optimiert für LMStudio

Alarmierung / Signalerzeugung

• Slack-Webhook-Unterstützung (Informationen zur Einrichtung von Webhooks finden Sie hier: https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/)
• Strukturierte Ausgabe, geeignet für Automatisierung
• Für die Integration in größere Arbeitsabläufe konzipiert

Lokal & selbst gehostet

• Abgesehen vom Abrufen von RSS-Feeds oder dem Senden von Antworten an Slack (optional) verbleiben alle Informationen auf von Ihnen kontrollierter Hardware.

Anforderungen

• Python 3.10+
• Abhängigkeiten gelistet in requirements.txt:
  • PySide6==6.10.0
  • feedparser==6.0.12
  • requests==2.31.0
  • python-dateutil==2.9.0.post0

LLM gehostet via:

• LM Studio-gehostet (empfohlen)
• Ollama
• OpenAI API-Key
• (bald kommen noch einige hinzu)

Installation

1. Repository klonen (…oder das Zip herunterladen) & in den Ordner wechseln

git clone https://github.com/EverythingsComputer/ShunyaNet-Sentinel.git
cd ShunyaNet-Sentinel

2. (Stark empfohlen) Virtuelle Umgebung erstellen

macOS / Linux:

python3 -m venv venv
source venv/bin/activate

Windows (PowerShell):

python -m venv venv
venv\Scripts\Activate.ps1

3. Anforderungen installieren

pip install -r requirements.txt

4. Ausführen

macOS / Linux:

python3 ShunyaNet_Sentinel.py

Windows:

python ShunyaNet_Sentinel.py

Schnellstart (mit LMStudio) (AKTUALISIERT 23.02.)

1. Klicke auf „Prompt-Datei laden“ und lade default_prompt.txt
2. Klicke auf „Datenquellen-Datei laden“ und lade die RSS-Liste Default_test
3. Öffne „Zusätzliche Einstellungen“ und gib Folgendes ein:
   • LM_PROVIDER = lmstudio
   • LLM_BASE_URL = <DEINE LMSTUDIO-SERVER-IP, z. B.: http://x.x.x.x:port/v1>
   • LLM_MODEL = <Ich empfehle, dies leer zu lassen. Folge einfach Schritt 4>
   • API_KEY = <leer lassen, es sei denn, du hast einen für deinen Server festgelegt>
4. Lade das Modell in LM Studio. Aktiviere unter Servereinstellungen „Im lokalen Netzwerk bereitstellen“. Tipps:
   • Aktiviere im Fenster „Modell laden“/Modellauswahl die Option „Modell-Ladeparameter manuell wählen“
   • Setze im Fenster „Ladeparameter deines Modells“ die maximalen gleichzeitigen Vorhersagen auf 1 (vorerst).
   • Deaktiviere oder minimiere auf dem Inferenz-Tab das „Thinking“, falls verfügbar.
   • Ein mittelgroßes Modell, das gut funktioniert: gpt-oss-20b. Thinking auf „niedrig“ gesetzt.
5. Klicke auf die Katze! (…oder drücke einfach „Abrufen / Senden“)

Vollständige Anleitung & Konfiguration (AKTUALISIERT 03/02/2026)

1. Gib interessante Themen ein oder lade eine der Standardlisten. Es können bis zu 10 Themen pro Liste hinzugefügt werden.

2. Klicke auf „Prompt-Datei laden“, um eine Prompt-Datei zu laden. Ein Standard-Prompt wird bereitgestellt (default_prompt.txt).

   1. Du bist ermutigt, dieses Prompt nach Belieben anzupassen – das kann die Berichtsqualität und die Fähigkeit des LLM, Signale im Rauschen zu erkennen, erheblich verbessern. Es gibt VIEL Raum für Anpassungen.
   2. Es gibt im Ordner „experimental“ ein default_prompt-always-reply.txt (veraltet). Du kannst es aber verwenden, um die LLM-Analyse zu debuggen/testen und sicherzustellen, dass es etwas im richtigen Format zurückmeldet.
   3. AKTUALISIERT 03/02/2026 Es wird auch ein Prompt default_Summary-Report-Only_prompt.txt bereitgestellt. Diese Version versucht nicht, ein Signal aus dem Rauschen zu filtern, sondern fasst eine größere Menge relevanter Feeds zusammen, wenn der Informationsraum reich an themenbezogenen Daten ist. Daher ist sie nützlicher, nachdem das gesuchte „Ereignis“ eingetreten ist. Sie wird am besten weniger häufig verwendet (z. B. alle halbe Stunde bei einem sich schnell entwickelnden und viel berichteten Ereignis oder alle paar Stunden bei weniger berichteten Daten) und mit einer großzügigen Token-Zuteilung für das Prompt und die Antwort.

3. Klicke auf „Datenquellen-Datei laden“, um eine RSS-Liste zu laden. Zwei Standardlisten werden bereitgestellt. Eine kurze Liste „Default_test“ und eine längere Liste „Default_long“, die sich auf weltweite Nachrichten und aktuelle Schlagzeilen konzentriert.

   1. Das Anpassen eigener Listen an deine Region oder Interessensgebiete wird die Informationsausgabe erheblich beeinflussen. Eine beispielhafte regionsspezifische Liste, die ich für eine kürzliche Reise verwendet habe, ist beigefügt (India_regional_example-v1.txt). Ein Beispiel für einen Iran-Konflikt ist ebenfalls enthalten.
   2. Reddit und Bluesky können leicht in RSS-Feeds umgewandelt werden. Programme wie RSSBridge können auch RSS-Feeds von Websites und sozialen Medien (z. B. Telegram) generieren, die keinen eigenen Feed haben.

6. Lade dein Modell (z. B. in LMStudio, Ollama) oder besorge dir einen API-Key (z. B. für OpenAI) und achte darauf, dass sein Kontextfenster den Wert, den du in den TOKENS_INPUT-Feldern von ShunyaNet Sentinel einträgst, bequem überschreitet. Das Programm ist derzeit für die Kompatibilität mit LMStudio, Ollama und OpenAI (per API-Key) ausgelegt. Gehe dann in den „Zusätzlichen Einstellungen“ von ShunyaNet Sentinel und fülle die folgenden Felder entsprechend deiner LLM-Lösung aus:

LMSTUDIO

• LLM_PROVIDER = lmstudio
• LLM_BASE_URL = <deine LMStudio-Server-URL, z. B.: http://localhost:1234/v1>
• LLM_MODEL = <OPTIONAL. Ich empfehle, dies leer zu lassen und dein Modell direkt in LMStudio zu laden. Falls nötig, lautet das Format: lmstudio-community/mistral-7b-instruct>
• LLM_API_KEY = <Leer lassen, es sei denn, du verwendest einen Authentifizierungsschlüssel>

OLLAMA

• LLM_PROVIDER = ollama
• LLM_BASE_URL = <deine LMStudio-Server-URL, z. B.: http://localhost:11434/v1>
• LLM_MODEL = llama3
• LLM_API_KEY = = <leer lassen>

OPENAI (per API-KEY)

• LLM_PROVIDER = openai
• LLM_BASE_URL = (egal: dieses Feld wird ignoriert)
• LLM_MODEL = gpt-4o-mini
• LLM_API_KEY = sk-xxxx

7. Fertig! – Klicke jetzt auf die Katze! (…oder drücke „Abrufen / Senden“, oder warte einfach die Anzahl an Sekunden, die du in FETCH_INTERVAL eingestellt hast)

HINWEIS: Ich empfehle, es beim ersten Durchlauf einfach zu halten. Verwende die Standardeinstellungen und stelle sicher, dass es funktioniert. Passe dann Kontext und RSS-Feeds an. Danach passe das Prompt an. Mich würde interessieren, welche verbesserten Prompts die Leute einreichen ….

Tipps, Tricks und bekannte Probleme

Probleme/Warnungen:

• Sentinel beendet sich unter Windows 11 nach einigen Stunden spontan. Keine Ahnung warum. Keine Fehlermeldungen. Tritt unter Mac oder Linux nicht auf – und vielleicht ist dein System anders! Wenn du dieses Problem hast und Windows verwenden musst, empfehle ich, eine virtuelle Box mit Linux/Ubuntu einzurichten (oder eine bessere Lösung vorzuschlagen, falls vorhanden!). Hinweis: Dieses Programm läuft problemlos auf einem Raspberry Pi!
• Schlechte Konfigurationsentscheidungen können dein LLM oder deine Hardware überlasten. Stelle sicher, dass dein LLM zuverlässig und schneller verarbeiten und antworten kann als dein RSS-Abrufintervall.
• LMStudio hat kürzlich die Fähigkeit („parallel“) implementiert, dass ein LLM mehr als ein Prompt gleichzeitig annehmen und verarbeiten kann. Schalte dies aus, bis du es mit dieser App getestet hast, sonst kann es zu Timeout-Fehlern und einem Rückstau ständig verarbeiteter Prompts kommen.
• Unter macOS (vielleicht auch Linux) wird manchmal eine Fehlermeldung ausgegeben, wenn die App geschlossen wird. Es scheint jedoch die Programmfunktion oder -stabilität nicht zu beeinträchtigen. Ich habe das einmal behoben, aber es kam zurück. Ich werde es irgendwann noch einmal beheben.
• Eine langsame oder 404-URL kann den Feed-Abruf verlangsamen. Überwache daher gelegentlich deine Logs, um solche URLs zu entfernen. Die Standard-RSS-Listen enthalten einige davon, aber es ist handhabbar.

Vorschläge:

• Der erste Abruf/Sende-Durchlauf ist ein Stresstest: Er ruft das maximale Feed-Volumen für deine Einstellungen ab und enthält daher wahrscheinlich veraltete Informationen. Dies ist jedoch eine gute Möglichkeit, zu testen, ob alles funktioniert, die längste Prompt-Verarbeitungszeit zu verstehen und eine Probe zu erhalten, wie dein Prompt, deine RSS-Liste und die Themenliste funktionieren.
• Einige „Thinking“-Modelle liefern fehlerhafte Antworten oder bleiben in Schleifen hängen. Ich empfehle, Thinking zunächst auszuschalten. Auf „niedrig“ gesetztes Thinking funktioniert bei GPT OSS gut.
• Es gibt zahlreiche Tricks, um Feeds zu senden, die standardmäßig kein RSS haben (z. B. über RSSBridge). Auch einige soziale Seiten können automatisch in RSS-Feeds umgewandelt werden (z. B. durch Anhängen von .rss an eine Reddit-URL oder /RSS an eine Bluesky-Profil-URL).
• Einige Websites, insbesondere Reddit, drosseln deine RSS-Abrufe. Um dieses Problem zu minimieren, empfehle ich dringend, die Reihenfolge deiner RSS-URL-Liste zu randomisieren, damit du nicht zu schnell dieselbe Website erreichst.

Status

Alpha

Lizenz

Dieses Projekt ist unter der Apache 2.0-Lizenz lizenziert.

Namensnennung: ShunyaNet / EverythingsComputer

Keine Gewährleistung: Die Software wird „wie besehen“ ohne jegliche ausdrückliche oder stillschweigende Garantie bereitgestellt.

Abhängigkeiten

Dieses Projekt verwendet die folgenden Drittanbieter-Bibliotheken. Bitte überprüfen Sie deren Lizenzen, wenn Sie dieses Projekt verwenden, verteilen und/oder verändern:

• PySide6 — LGPL
• feedparser — BSD
• requests — Apache 2.0
• python-dateutil — BSD

Namensursprung

Meine Katze.