
ShunyaNet Sentinel è un programma leggero che monitora i feed RSS, li invia a un LLM per l'analisi e fornisce riepiloghi o avvisi direttamente alla GUI e a Slack.
ShunyaNet Sentinel è un programma leggero a tema cyberpunk che acquisisce feed RSS (notizie dell'ultima ora, social media, avvisi governativi), li invia a un LLM per l'analisi e recapita avvisi e report riepilogativi alla GUI e ai tuoi canali di notifica a intervalli regolari.
Il progetto utilizza un LLM ospitato localmente sulla stessa macchina o rete (ad esempio con Tailscale) tramite LM Studio, Ollama o llama.cpp — oppure l'API OpenAI. Le notifiche funzionano tramite Slack, Discord, Telegram, ntfy, qualsiasi webhook generico e popup desktop (usane quanti vuoi contemporaneamente).
Compatibile con le versioni attuali di Linux, macOS e Windows.
La qualità dei report dipende dal tuo prompt, dalla dimensione del contesto, dai feed RSS e dall'LLM. Potrebbe essere necessario disattivare le funzionalità di "thinking" se il tuo modello le possiede. Io lo uso soprattutto con Qwen3.8 27B e Qwen3.8 Flash Next. Anche i modelli Gemma dovrebbero essere piuttosto validi.
agent_handoff.json così che script e agenti AI possano consumare l'output di Sentinel senza toccare la GUI/v1/chat/completions compatibile con OpenAI: LM Studio, Ollama, llama.cpp, OpenAI#> ALERT / #> SUMMARY / #> MEMORYA parte il polling dei feed RSS e l'invio delle notifiche (entrambi opzionali), tutte le informazioni restano su hardware che controlli tu.
Sentinel scrive artefatti stabili e leggibili dalla macchina accanto a ogni report: Report_Output/agent_handoff.json punta al file di avviso/riepilogo più recente e ai file di memoria. Qualsiasi agente locale può interrogare quel singolo file JSON per seguire ciò che Sentinel sta vedendo. Consulta docs/AGENT-INTEGRATION.md per il contratto completo, e Aiuto → Integrazione con agenti / script all'interno dell'app.
requirements.txt): PySide6, feedparser, requestsLLM ospitato tramite:
git clone https://github.com/EverythingsComputer/ShunyaNet-Sentinel.git
cd ShunyaNet-Sentinel
macOS / Linux:
python3 -m venv venv
source venv/bin/activate
Windows (PowerShell):
python -m venv venv
venv\Scripts\Activate.ps1
pip install -r requirements.txt
macOS / Linux: python3 ShunyaNet_Sentinel.py
Windows: python ShunyaNet_Sentinel.py
Al primo avvio, Sentinel ti guida nella configurazione tramite una Procedura guidata di configurazione (riapribile in qualsiasi momento con Ctrl+W o Aiuto → Procedura guidata di configurazione):
Configurazione manuale (saltando la procedura guidata):
.txt, un URL RSS per riga — l'elenco caricato viene ricordato tra un riavvio e l'altro).Ctrl+,) → scheda Connessione: scegli il provider, imposta l'URL del server (esempio LM Studio: http://localhost:1234/v1), premi Verifica connessione, Salva e applica.Ctrl+Enter, o attendi il conto alla rovescia del recupero automatico nella barra di stato)Per inviare avvisi al tuo telefono: Impostazioni → Notifiche → compila un canale (Slack/Discord/Telegram/ntfy), premi Invia notifica di prova, Salva e applica. I suggerimenti di configurazione per ciascun servizio sono nei tooltip di quella scheda.
Ogni impostazione ha un tooltip al passaggio del mouse; Aiuto (F2) elenca le scorciatoie da tastiera. Screensaver matrix-rain: F1.