How andrewmbarros/beatles-bot works
Beatles Bot monitors Beatles-related news and social sources, filters and deduplicates items, then sends immediate alerts or periodic digests to Telegram. The main runtime is concentrated in one Python file: its CLI configures dry-run or Telegram delivery, while the documented deployment options run it continuously or on a schedule. The README also documents source-health alerts and persistent history. Several internal call paths are only partially excerpted, so uncertain links are omitted rather than inferred.
Main entry points: beatles_news.py Run coordinator · seen.json Seen history
Components 17
Source collection
- 46-source catalog
beatles_news.py - News and feed sources
beatles_news.py - Social and forum sources
beatles_news.py - Due-source fetching
beatles_news.py
Item processing
- Feed parsing
beatles_news.py - Bluesky parsing
beatles_news.py - Filtering and labeling
beatles_news.py - Deduplication
beatles_news.py - Digest assembly
beatles_news.py - Source health alerts
beatles_news.py
Delivery and state
- Telegram delivery
beatles_news.py - Seen history
seen.json
Runtime
- CLI modes
beatles_news.py - Run coordinator
beatles_news.py
Other components
- Operator
- Deployment scheduler
- Telegram Bot API
Connections 21
- Operator → CLI modes: selects mode
README.md - CLI modes → 46-source catalog: builds sources
beatles_news.py - Deployment scheduler → CLI modes: starts runs
README.md - 46-source catalog → News and feed sources: includes feeds
README.md - 46-source catalog → Social and forum sources: includes social
README.md - Run coordinator → Due-source fetching: fetches due
beatles_news.py - News and feed sources → Due-source fetching: provides sources
beatles_news.py - Social and forum sources → Due-source fetching: provides sources
beatles_news.py - Due-source fetching → Feed parsing: parses feeds
beatles_news.py - Due-source fetching → Bluesky parsing: parses posts
beatles_news.py - Feed parsing → Filtering and labeling: filters items
beatles_news.py - Bluesky parsing → Filtering and labeling: filters items
beatles_news.py - Run coordinator → Source health alerts: checks failures
beatles_news.py - Run coordinator → Deduplication: checks history
beatles_news.py - Deduplication → Seen history: records items
README.md - Run coordinator → Digest assembly: assembles digest
beatles_news.py - Run coordinator → Telegram delivery: sends alerts
README.md - Source health alerts → Telegram delivery: sends outage alert
README.md - Digest assembly → Telegram delivery: sends summary
README.md - Telegram delivery → Telegram Bot API: calls API
beatles_news.py - CLI modes → Run coordinator: runs cycle
beatles_news.py