Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
ShunyaNet-Sentinel — ShunyaNet Sentinel is a lightweight program that monitors RSS feeds, sends them to an LLM for analysis, and delivers summaries or alerts directly to the GUI and Slack. | Kitploit
Tools/GitHubGitHub/everythingscomputer/shunyanet-sentinel
OSINT (Open Source Intelligence)Information GatheringUtilities & FrameworksThreat IntelligenceLearning & Education
GitHubeverythingscomputer/shunyanet-sentinel

ShunyaNet-Sentinel

ShunyaNet Sentinel is a lightweight program that monitors RSS feeds, sends them to an LLM for analysis, and delivers summaries or alerts directly to the GUI and Slack.

Share
View Repository
4043325 days agoReviewed by Kitploit
ShunyaNetSentinelAppGraphicV1

ShunyaNet Sentinel (v3.3) - MAJOR UPDATE (UPDATED: 10/22/2026)

ShunyaNet Sentinel is a lightweight, cyberpunk-themed program that ingests RSS feeds (breaking news, social media, government alerts), sends them to an LLM for analysis, and delivers alerts and summary reports to the GUI and your notification channels at regular intervals.

The project uses an LLM hosted locally on the same machine or network (e.g., with Tailscale) via LM Studio, Ollama, or llama.cpp — or the OpenAI API. Alerting works over Slack, Discord, Telegram, ntfy, any generic webhook, and desktop popups (use as many at once as you want).

Compatible with current versions of Linux, macOS, and Windows.

The quality of reporting depends on your prompt, context size, RSS feeds, and LLM. You may need to turn off "thinking" features if your model has them. I use this most with Qwen3.8 27B and Qwen3.8 Flash Next. Gemma models should be pretty good, too.


High-Level Workflow

  1. Enter topics of interest (the Setup Wizard walks you through this on first launch)
  2. Provide a list of RSS feeds (bundled lists included, one URL per line)
  3. Sentinel pulls feeds at your configured interval
  4. Feed content goes to your LLM server
  5. The LLM screens for alerts and, periodically, writes trend reports
  6. Alerts/summaries land in the GUI and every notification channel you configured (phone push via Slack/Discord/Telegram/ntfy)
  7. Every report is also saved as a plain text file — including an agent_handoff.json index so scripts and AI agents can consume Sentinel's output without touching the GUI

Core Capabilities

RSS Feed Monitoring

  • Periodic polling, fetched in parallel but serialized per-host (polite to rate limiters like Reddit)
  • Deduplication by entry GUID; per-source failure logging
  • Handles slow or malformed feeds without blocking the UI

LLM-Based Analysis

  • Works with any OpenAI-compatible /v1/chat/completions endpoint: LM Studio, Ollama, llama.cpp, OpenAI
  • One prompt file drives both modes via #> ALERT / #> SUMMARY / #> MEMORY sections
  • Automatic chunking when pulls exceed your token budget

Alerting

  • Slack incoming webhook
  • Discord channel webhook
  • Telegram bot (token + chat ID)
  • ntfy topic URL (free, no-account phone push; self-hostable)
  • Generic webhook (POSTs JSON — Home Assistant, scripts, anything)
  • Desktop popups via the system tray
  • Per-channel Test button in Settings → Notifications using the values you just typed, before saving
  • Toggle whether periodic summaries also go out, or only instant alerts

Local & Self-Hosted

Other than polling RSS feeds and sending your notifications (both optional), all information stays on hardware you control.

Agent / Script Integration

Sentinel writes stable, machine-readable artifacts beside every report: Report_Output/agent_handoff.json points at the newest alert/summary file plus the memory files. Any local agent can poll that one JSON file to follow what Sentinel is seeing. See docs/AGENT-INTEGRATION.md for the full contract, and Help → Agent / Script Integration inside the app.


Requirements

  • Python 3.10+
  • Dependencies (see requirements.txt): PySide6, feedparser, requests

LLM hosted via:

  • LM Studio (recommended)
  • Ollama
  • llama.cpp server
  • OpenAI API key

Installation

1. Clone (or download the ZIP) and enter the folder

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

2. (Strongly recommended) Create a virtual environment

macOS / Linux:

python3 -m venv venv
source venv/bin/activate

Windows (PowerShell):

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

3. Install requirements

pip install -r requirements.txt

4. Run

macOS / Linux: python3 ShunyaNet_Sentinel.py Windows: python ShunyaNet_Sentinel.py


Quick Start

On first launch, Sentinel walks you through setup with a guided Setup Wizard (reopen anytime with Ctrl+W or Help → Setup Wizard):

  1. Topics – your overall topic and signals (one per line). Autosaves as you type.
  2. Model connection – pick your provider (LM Studio and other local servers live under "OpenAI-compatible"; hosted picks include OpenAI, Claude, Gemini, OpenRouter, Groq, Mistral, DeepSeek, Together, Grok); the wizard shows exactly what to enter, with a Test Connection button so you know it works before relying on it.
  3. Feeds – one click loads a bundled list: Quick-Start (short), World News (long), or a topic list (AI & Technology, Cybersecurity, Finance & Markets, Climate & Disasters, Health & Outbreaks, Geopolitics & Conflict).
  4. Confirm – review and launch your first fetch (the button actually fetches).

Manual setup (skipping the wizard):

  1. Enter topics in the Targeting panel.
  2. Pick a starting point: Profiles → choose a bundled topic profile, and File → Bundled Source Lists → pick the matching feed list (or load your own .txt, one RSS URL per line — your loaded list is remembered across restarts).
  3. Run → Settings (Ctrl+,) → Connection tab: choose provider, set the Server URL (LM Studio example: http://localhost:1234/v1), press Test Connection, Save & Apply.
  4. Load a model in LM Studio and turn on "Serve on Local Network" in Server Settings. Tips:
    • In the Load Model window, turn on "Manually choose model load parameters"
    • Set Max Concurrent Predictions to 1 (for now)
    • Turn off or minimize thinking, if available
    • A solid moderate choice: gpt-oss-20b, thinking "low"
  5. Click the cat! (...or hit Fetch / Send with Ctrl+Enter, or wait for the auto-fetch countdown in the status bar)

To push alerts to your phone: Settings → Notifications → fill one channel (Slack/Discord/Telegram/ntfy), press Send Test Notification, Save & Apply. Setup hints for each service are in that tab's tooltips.

Every setting has a hover tooltip; Help (F2) lists keyboard shortcuts. Matrix-rain screensaver: F1.


Full Instructions & Config

  1. Topics — enter topics in the Targeting panel (autosaves). Save named sets as Profiles to switch watch-lists quickly. Your loaded feed list is part of app state and persists across restarts.

    Sentinel ships with 11 ready-made topic profiles (topic_profiles.default.json) that are installed automatically on first run into your own topic_profiles.json — after that the file is yours: edit, delete, add, and your changes are never overwritten. Brought a fresh clone or deleted one you liked? Profiles → Restore Bundled Topic Profiles… merges back only the shipped profiles you are missing.

    A profile has two fields, matching the Targeting panel: overall_topic (one sentence framing what counts as news) and subtopics (newline-separated signal lines — write each as what to look for, plus examples in parentheses; specific signals screen far better than broad subject words).

Download Tool

Most Popular

View all →

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    524
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    478
  • 3

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    357
  • 4

    redforge

    cybersecurity91/redforge

    Browser-side red team toolkit with 102 offline tools for recon, payload generation, credential attacks, crypto, encoding and engagement reporting.

    317
  • 5

    estorides

    grisuno/estorides

    Aggregates 99+ free OSINT sources in parallel, resolves entities into a knowledge graph, and exports STIX 2.1, MISP, or GraphML with LLM-assisted analysis.

    305
  • 6

    opencti

    opencti-platform/opencti

    Open Cyber Threat Intelligence Platform

    275

Explore all tools

Browse our collection of tools

View all tools →