How samgozman/fin-thread works
FinThread aggregates financial news and autonomously turns it into Telegram posts. Scheduled jobs coordinate the main news workflow—fetching provider articles, filtering and composing them with AI, checking for duplicates, storing results, and publishing—and separately handle calendar reporting, event updates, and news summaries. The README also documents stock detection and multiple AI providers. Evidence is strongest for the sampled news and calendar paths; some capability nodes and integrations are based on README documentation or source-index references rather than inspected implementation.
Main entry points: job.go News job · app.go Job scheduler · summary.go Summary job · calendar.go Calendar jobs
Components 18
Scheduling and jobs
- Job scheduler
app.go - News job
jobs/job.go - Summary job
jobs/summary.go - Calendar jobs
jobs/calendar.go
News processing
- AI filtering and composition
composer/composer.go - AI clients
composer/clients.go - Telegram publishing
publisher/publisher.go - News summarization
composer/composer.go
Sources and persistence
- News collection
journalist/news.go - Stock detection
scavenger/stocks/stocks.go - News and event archive
archivist/News.go
Calendar reporting
- Calendar retrieval
scavenger/ecal/ecal.go
Other components
- Channel operator
- News providers
- PostgreSQL
- Telegram channel
- Economic calendar source
- Stock data source
Connections 22
- Channel operator → Job scheduler: runs service
README.md - Job scheduler → News job: schedules
app.go - Job scheduler → Calendar jobs: schedules
app.go - News job → News collection: fetches articles
jobs/job.go - News providers → News collection: provides feeds
README.md - News job → AI filtering and composition: filters and composes
jobs/job.go - AI filtering and composition → AI clients: requests completions
composer/composer.go - AI clients → Channel operator: calls AI services
- News job → Stock detection: uses stock data
- Stock detection → Stock data source: fetches listings
scavenger/stocks/stocks.go - News job → News and event archive: reads and writes news
jobs/job.go - News and event archive → PostgreSQL: persists records
- News job → Telegram publishing: publishes posts
jobs/job.go - Telegram publishing → Telegram channel: sends messages
publisher/publisher.go - Job scheduler → Summary job: schedules
- Summary job → AI filtering and composition: requests summaries
- Summary job → News and event archive: retrieves news
- Summary job → Telegram publishing: publishes summary
- Calendar jobs → Calendar retrieval: fetches events
jobs/calendar.go - Calendar retrieval → Economic calendar source: requests events
scavenger/ecal/ecal.go - Calendar jobs → News and event archive: stores and updates
jobs/calendar.go - Calendar jobs → Telegram publishing: publishes updates
jobs/calendar.go