How utsapoddar/alpha-digest works
Alpha Digest’s main workflow loads a tracked-entity watchlist, gathers SEC filings, market data, and news, enriches that evidence, generates structured summaries, then renders and distributes an email and archived web issue. The README documents the major source and delivery capabilities; sampled source confirms the coordinator and several implementations, while some fetcher and configuration wiring is represented only at the documented capability level.
Main entry points: main.py Pipeline coordinator · feeds.py Configured feeds · summarizer.py Structured summarizer · sec_edgar.py SEC filings
Components 27
Run coordination
- Pipeline coordinator
main.py - Runtime configuration
digest/config.py - Entity watchlist
watchlist.csv - Source switches
config/sources.yaml - Run boundary state
main.py
Evidence collection
- SEC filings
digest/fetchers/sec_edgar.py - Crypto treasury
digest/fetchers/crypto.py - Commodity moves
digest/fetchers/commodities.py - Entity news
digest/fetchers/news.py - Configured feeds
digest/fetchers/feeds.py - Feed sources
config/feeds.csv
Enrichment and analysis
- Evidence enrichment
digest/enrichers/context.py - Structured summarizer
digest/summarizer.py
Issue delivery
- Email and web rendering
digest/renderer.py - Digest templates
templates - Email delivery
digest/notifier.py - Archive publisher
digest/publisher.py
Other components
- Weekly schedule
- SEC EDGAR
- CoinGecko
- Yahoo Finance
- Google News
- RSS providers
- Gemini models
- NVIDIA NIM
- Gmail SMTP
- GitHub Pages
Connections 26
- Weekly schedule → Pipeline coordinator: starts run
- Pipeline coordinator → Runtime configuration: loads settings
- Pipeline coordinator → Source switches: reads switches
- Pipeline coordinator → Entity watchlist: loads entities
- Pipeline coordinator → Run boundary state: reads and saves
- Pipeline coordinator → SEC filings: calls fetcher
- Pipeline coordinator → Crypto treasury: calls fetcher
- Pipeline coordinator → Commodity moves: calls fetcher
- Pipeline coordinator → Entity news: calls fetcher
- Pipeline coordinator → Configured feeds: calls fetcher
- SEC filings → SEC EDGAR: requests filings
- Crypto treasury → CoinGecko: requests treasury data
- Commodity moves → Yahoo Finance: requests price data
- Entity news → Google News: fetches headlines
- Configured feeds → Feed sources: reads sources
- Configured feeds → RSS providers: fetches headlines
- Pipeline coordinator → Evidence enrichment: passes evidence
- Pipeline coordinator → Structured summarizer: submits enriched data
- Structured summarizer → Gemini models: tries models
- Structured summarizer → NVIDIA NIM: falls back
- Pipeline coordinator → Email and web rendering: renders summary
- Email and web rendering → Digest templates: renders with
- Pipeline coordinator → Email delivery: sends email edition
- Email delivery → Gmail SMTP: delivers message
- Pipeline coordinator → Archive publisher: publishes web edition
- Archive publisher → GitHub Pages: updates archive