
ShunyaNet Sentinel은 RSS 피드를 모니터링하고, 이를 LLM에 보내 분석하며, 요약이나 알림을 GUI와 Slack으로 직접 전달하는 경량 프로그램입니다.
ShunyaNet Sentinel은 RSS 피드(속보, 소셜 미디어, 정부 경보)를 수집하여 LLM에 분석을 요청하고, 경보와 요약 보고서를 GUI 및 사용자의 알림 채널로 정기적으로 전달하는 가볍고 사이버펑크 테마의 프로그램입니다.
이 프로젝트는 LM Studio, Ollama, llama.cpp를 통해 동일한 머신이나 네트워크(예: Tailscale 사용)에 로컬로 호스팅된 LLM을 사용하거나, OpenAI API를 사용합니다. 알림은 Slack, Discord, Telegram, ntfy, 모든 범용 웹훅, 데스크톱 팝업을 통해 작동합니다(원하는 만큼 동시에 사용 가능).
Linux, macOS, Windows의 최신 버전과 호환됩니다.
보고 품질은 프롬프트, 컨텍스트 크기, RSS 피드, LLM에 따라 달라집니다. 모델에 "thinking" 기능이 있다면 꺼야 할 수도 있습니다. 저는 주로 Qwen3.8 27B와 Qwen3.8 Flash Next와 함께 사용합니다. Gemma 모델도 꽤 괜찮을 것입니다.
agent_handoff.json 인덱스 포함/v1/chat/completions 엔드포인트와 작동: LM Studio, Ollama, llama.cpp, OpenAI#> ALERT / #> SUMMARY / #> MEMORY 섹션을 통해 두 모드를 모두 구동RSS 피드 폴링과 알림 전송(둘 다 선택 사항)을 제외하면, 모든 정보는 사용자가 통제하는 하드웨어에 남습니다.
Sentinel은 모든 보고서 옆에 안정적이고 기계가 읽을 수 있는 산출물을 작성합니다. Report_Output/agent_handoff.json은 최신 경보/요약 파일과 메모리 파일을 가리킵니다. 모든 로컬 에이전트는 이 단일 JSON 파일을 폴링하여 Sentinel이 보고 있는 내용을 따라갈 수 있습니다. 전체 계약은 docs/AGENT-INTEGRATION.md와 앱 내 도움말 → 에이전트 / 스크립트 통합을 참조하세요.
requirements.txt 참조): PySide6, feedparser, requests다음을 통해 호스팅되는 LLM:
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
첫 실행 시 Sentinel은 안내형 설정 마법사로 설정 과정을 안내합니다(Ctrl+W 또는 도움말 → 설정 마법사로 언제든 다시 열 수 있음):
수동 설정(마법사 건너뛰기):
.txt를 불러오세요 — 불러온 목록은 재시작 후에도 유지됩니다).Ctrl+,) → Connection 탭: 제공자를 선택하고, Server URL을 설정합니다(LM Studio 예: http://localhost:1234/v1), 연결 테스트를 누르고, Save & Apply를 누릅니다.Ctrl+Enter로 Fetch / Send를 누르거나, 상태 표시줄의 자동 가져오기 카운트다운을 기다리세요)휴대폰으로 알림을 보내려면: Settings → Notifications → 채널 하나를 채우고(Slack/Discord/Telegram/ntfy), 테스트 알림 보내기를 누르고, Save & Apply를 누릅니다. 각 서비스의 설정 힌트는 해당 탭의 툴팁에 있습니다.
모든 설정에는 마우스를 올리면 표시되는 툴팁이 있습니다. 도움말(F2)에는 키보드 단축키가 나열되어 있습니다. 매트릭스 레인 화면 보호기: F1.
주제 — Targeting 패널에 주제를 입력합니다(자동 저장). 명명된 세트를 Profiles로 저장하여 감시 목록을 빠르게 전환하세요. 불러온 피드 목록은 앱 상태의 일부이며 재시작 후에도 유지됩니다.
Sentinel에는 11개의 기본 제공 주제 프로필(topic_profiles.default.json)이 포함되어 있으며, 첫 실행 시 자동으로 자신의 topic_profiles.json에 설치됩니다 — 그 이후로는 파일은 당신의 것입니다: 편집, 삭제, 추가해도 변경 사항이 절대 덮어쓰이지 않습니다. 새로 클론했거나 마음에 들던 프로필을 삭제했나요? **Profiles → Restore Bundled Topic Profiles…**는 누락된 기본 제공 프로필만 다시 병합합니다.
프로필에는 Targeting 패널과 일치하는 두 개의 필드가 있습니다: overall_topic(무엇이 뉴스로 간주되는지 설명하는 한 문장)과 subtopics(줄바꿈으로 구분된 신호 줄 — 각각을 무엇을 찾을지로 작성하고 괄호 안에 예시를 넣으세요. 구체적인 신호가 광범위한 주제어보다 훨씬 잘 걸러냅니다).
프롬프트: 파일 하나로 모두 처리(sentinel_prompt.txt). 자동으로 로드되며 표시된 섹션을 포함합니다:
#> ALERT — 모든 가져오기와 함께 전송되는 지침(즉시 알림 심사)#> SUMMARY — 주기적 트렌드 보고서용 지침#> MEMORY — 장기 기억 정책. Sentinel은 기억 프로파일러가 활성화된 동안에만 이를 요약 프롬프트에 추가합니다#> 마커가 없는 프롬프트 파일은 두 모드 모두에서 전체가 사용됩니다. File → Load Prompt File은 파일을 교체합니다(감지된 섹션을 보고합니다). {TOPICS}, {CHUNK}, {LONG_TERM_MEMORY} 토큰은 전송 시점에 채워집니다. 문구를 조정하면 신호 품질이 크게 향상될 수 있습니다.
데이터 소스 — "Load Data Sources…"는 한 줄에 하나의 RSS URL이 있는 .txt 파일(# 주석 허용) 또는 JSON 목록을 받습니다. 아래에 포함된 모든 목록은 배포 시점에 실제로 검증되었습니다(HTTP 200 + 파싱 가능한 항목). 각 목록은 같은 이름의 토픽 프로필과 함께 사용하세요:
| 포함된 목록 | 피드 수 | 토픽 프로필 | 적합한 용도 |
|---|---|---|---|
Default_test-v1.txt | 31 | General News & Breaking V1 | 첫 실행: 짧고 다양하여 느린 모델도 빠르게 완료 |
Default_long-v1.txt | 127 | World News Deep Dive V1 | 폭넓은 글로벌 커버리지: 통신사 + Reddit + Bluesky |
AI_Technology_V1.txt | 59 | AI & Technology V1 | 모델 출시, AI 규제, 칩/컴퓨팅, 기술 장애 |
Cybersecurity_V1.txt | 56 | Cybersecurity V1 | 침해 사고, 랜섬웨어, 악용된 CVE, 인프라 공격 |
Finance_Markets_V1.txt | 53 | Finance & Markets V1 | 시장 왜곡, 은행/신용 스트레스, 정책 서프라이즈, 암호화폐 |
Climate_Disasters_V1.txt | 58 | Climate & Disasters V1 | 급발성 재난과 기록적/기후 신호 |
Health_Outbreaks_V1.txt | 51 | Health & Outbreaks V1 | 초기 발병 신호, 의약품 부족/회수, 병원 수용력 |
Geopolitics_Conflict_V1.txt | 51 | Geopolitics & Conflict V1 | 확전 지표: 영공, 미사일, 해운, 외교 |
India_regional_example-v1.txt | 64 | India Regional Monitor V1 | 국가/지역 구축의 실제 예시(전국 + 도시 피드) |
Iran_List_V1.txt | 43 | Iran Conflict V2 | 단일 이벤트 구축의 실제 예시(통신사 + OSINT + Telegram) |
Irkutsk_plague_V1.txt | 24 | Irkutsk Plague Monitor (Example) | 좁고 이벤트 특화된 감시의 실제 예시 |
위의 모든 URL은 배포 시점에 실제로 검증되었습니다(HTTP 200 + 파싱 가능한 항목). 두 가지 주의사항: 피드는 썩기 마련이므로 응답이 중단된 줄은 삭제하세요. 그리고 Reddit은 대량으로 폴링되는 모든 것에 대해 공격적으로 속도 제한(HTTP 429)을 겁니다 — Sentinel은 호스트별로 요청을 직렬화하지만, 목록에 Reddit이 많다면 특정 주기에서 일부 소스가 건너뛰어질 수 있습니다.
Reddit URL은 .rss를 추가하면 작동합니다. Bluesky 프로필은 https://bsky.app/profile/NAME/RSS로 작동합니다. RSS-Bridge 같은 도구는 피드가 없는 사이트(예: Telegram)를 변환합니다. 목록 순서를 무작위화하여 속도 제한이 있는 사이트가 한꺼번에 몰려 맞지 않도록 하세요(Sentinel은 호스트별 요청을 자동으로 직렬화하기도 합니다).
Ctrl+,) — 6개의 탭, 모든 필드에 툴팁 제공: