Skip to content

black-hak/feedmind

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 FeedMind

Stop doomscrolling. Start knowing. FeedMind is a self-hosted, open-source AI-powered RSS briefing tool that reads all your feeds and delivers a clean, personalized 5-minute daily digest to your Telegram or email β€” every morning, zero noise.

Go Version License Docker Self-Hosted Privacy First


🎯 What is FeedMind?

You follow 50+ sources β€” security blogs, CVE feeds, GitHub releases, newsletters, tech news. You can't read them all. You shouldn't have to.

FeedMind reads everything for you. You get the summary.

Every morning at 7:00 AM:

πŸ›‘οΈ FeedMind Daily Briefing β€” May 9, 2026

πŸ”΄ CVE-2026-12345 (CVSS 9.8): RCE in Apache Log4j2 β€” Patch NOW
🟑 Cisco ASA Advisory: Privilege escalation β€” patch available
πŸ“Œ Krebs on Security: New EDR evasion technique in the wild
πŸ™ Trivy v0.45.0 released β€” improved SBOM support for containers
πŸ™ Vault v1.16.1 β€” patches CVE-2026-XXXX in token renewal

β†’ 5 sources Β· 4 min read

No apps to open. No tabs to check. Just what matters, in your Telegram.


✨ Features

  • πŸ“‘ Reads any RSS/Atom feed β€” blogs, CVE databases, GitHub releases, newsletters
  • 🧠 AI-powered summarization β€” uses a local LLM (Ollama) or cheap API (GPT-4o mini)
  • πŸ“± Telegram delivery β€” briefing arrives in your chat every morning
  • πŸ”’ Privacy-first β€” everything runs on your server; your feeds never leave your machine
  • 🐳 Docker-ready β€” up and running in under 60 seconds
  • πŸ›‘οΈ Security mode built-in β€” pre-configured feeds for CVEs, CISA advisories & threat intel
  • πŸ’Έ Near-zero cost β€” RSS is plain text; local LLMs cost fractions of a cent per summary
  • πŸ”“ Open-source β€” MIT license, no vendor lock-in, yours forever

⚑ Quick Start

Prerequisites

1. Clone the repo

git clone https://github.com/black-hak/feedmind.git
cd feedmind

2. Configure

cp .env.example .env
cp feeds.txt.example feeds.txt

Edit .env with your Telegram token, chat ID, and LLM settings. Edit feeds.txt to add your RSS sources (one URL per line).

3. Launch

docker-compose up -d

That's it. FeedMind will deliver your first briefing at the time you configured.


πŸ›‘οΈ Security Mode

FeedMind ships with a pre-configured security bundle β€” perfect for security professionals, SOC teams, and developers who need to stay on top of threats without drowning in noise.

Just use feeds.txt.example as-is and you'll get daily briefings covering:

Source What you get
NVD All new CVEs, filtered by CVSS score
CISA Advisories Actionable alerts from US Cyber Defense
Krebs on Security Trusted threat intel & deep analysis
Bleeping Computer Breaking security news
Exploit-DB Active exploits published today
Packet Storm Vulnerability disclosures & PoCs
GitHub Releases Updates for tools you depend on (Trivy, Vault, etc.)

The default LLM prompt is tuned to highlight only what requires action: critical CVEs (CVSS β‰₯ 9.0), active exploits, and advisories with patches available.


βš™οΈ Configuration

.env reference

# ─── Telegram ──────────────────────────────────────────
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here

# ─── LLM Provider ──────────────────────────────────────
# Options: ollama (local, free) | openai (cloud, cheap)
LLM_PROVIDER=ollama
LLM_BASE_URL=http://localhost:11434
LLM_MODEL=llama3:8b

# ─── AI Prompt ─────────────────────────────────────────
# Customize what the LLM focuses on.
# Default is tuned for security teams.
LLM_PROMPT="You are a senior security analyst. From the following feed items, extract ONLY: 1) Critical vulnerabilities (CVSS β‰₯ 9.0) published in the last 24h, 2) Advisories requiring immediate action (patch available), 3) Active exploits published today, 4) Notable tool releases from trusted sources. Use πŸ”΄ for critical, 🟑 for medium, πŸ™ for releases. Be concise. Max 600 characters. Ignore marketing, events, and non-actionable content."

# ─── Scheduling ────────────────────────────────────────
FEEDS_FILE=./feeds.txt
DAEMON_HOUR=7        # Delivery hour (0–23, local time)
FETCH_INTERVAL=1h    # How often to poll feeds in background
SQLITE_DB=./data/feedmind.db

feeds.txt format

One URL per line. Lines starting with # are comments.

# Security feeds
https://nvd.nist.gov/vuln/data-feeds/JSON_FEED
https://www.cisa.gov/cybersecurity-advisories/feed
https://krebsonsecurity.com/feed/

# GitHub releases (any repo you care about)
https://github.com/aquasecurity/trivy/releases.atom
https://github.com/hashicorp/vault/releases.atom

# Tech blogs
https://news.ycombinator.com/rss

πŸ—οΈ Architecture

feedmind/
β”œβ”€β”€ cmd/                    # CLI entrypoint
β”‚   └── main.go
β”œβ”€β”€ internal/
β”‚   β”œβ”€β”€ feeds/              # RSS/Atom parser & storage
β”‚   β”‚   └── parser.go
β”‚   β”œβ”€β”€ llm/                # LLM integration (Ollama / OpenAI)
β”‚   β”‚   └── summarizer.go
β”‚   β”œβ”€β”€ notify/             # Delivery channels (Telegram, email)
β”‚   β”‚   └── telegram.go
β”‚   └── scheduler/          # Cron-based daemon
β”‚       └── daemon.go
β”œβ”€β”€ data/                   # SQLite DB (auto-created, gitignored)
β”œβ”€β”€ feeds.txt.example       # Pre-configured security feeds
β”œβ”€β”€ .env.example            # Configuration template
β”œβ”€β”€ Dockerfile
β”œβ”€β”€ docker-compose.yml
go.mod
go.sum

πŸ”’ Privacy

FeedMind is designed so your data never has to leave your machine:

  • All feed data is stored in a local SQLite database (or your own Postgres instance)
  • When using Ollama, LLM inference runs 100% locally β€” no data sent to any API
  • Even when using OpenAI/Anthropic, only the feed summaries (not raw content) are sent
  • No telemetry, no analytics, no accounts required for self-hosted mode

πŸ—ΊοΈ Roadmap

  • Core RSS/Atom parser
  • LLM summarization (Ollama + OpenAI)
  • Telegram delivery
  • Docker + self-hosted support
  • Email delivery (SMTP)
  • Interactive Telegram bot (/addfeed, /setprompt, /brief)
  • Web UI for feed management
  • Cloud-hosted version β€” feedmind.app ($8/month, no server needed)
  • B2B security teams plan ($49/month, shared briefings + Slack integration)
  • Voice briefing via TTS (listen while you make coffee)

🀝 Contributing

Pull requests are welcome. For major changes, please open an issue first.

  1. Fork the repo
  2. Create your branch: git checkout -b feat/your-feature
  3. Commit your changes: git commit -m 'feat: add your feature'
  4. Push to the branch: git push origin feat/your-feature
  5. Open a Pull Request

πŸ“„ License

MIT β€” free to use, modify, and distribute.


Built with β˜• and 🧠 for the people who need to know everything but have time for nothing.

About

🧠 Open-source AI-powered RSS briefing β€” get a daily 5-min digest of CVEs, threat intel & tech releases delivered to your Telegram. Self-hosted, privacy-first, zero noise.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors