furic/richfolio](https:

What's New

Richfolio v1.0.0 — a zero-maintenance portfolio monitoring system with AI-powered buy signals, delivered daily via email and Telegram.

Features

• AI Buy Recommendations — Gemini 2.5 Flash analyzes valuation, allocation gaps, news sentiment, technicals, and risk
• Technical Momentum Signals — SMA50, SMA200, RSI(14), golden/death cross, momentum classification for every ticker
• Limit Order Prices — AI-suggested limit prices based on nearby support (moving averages, recent lows, round numbers)
• Allocation Gap Analysis — current vs target %, with suggested buy amounts
• Dynamic P/E Signals — trailing P/E compared against historical averages from Yahoo Finance
• ETF Overlap Detection — reduces buy priority when you hold overlapping stocks
• 52-Week Range Signals — highlights tickers near their 52w low or high
• News Digest — top headlines per ticker from NewsAPI
• Portfolio Health — weighted beta, estimated annual dividend income
• Intraday Alerts — periodic checks that alert only when buy signals strengthen vs morning brief
• Weekly Rebalancing Report — drift analysis with BUY/TRIM/OK actions
• Dual Delivery — dark-themed HTML email + condensed Telegram message

Stack

All free-tier services — $0/month to run:

| Component | Service |
|-----------|---------|
| Prices & Fundamentals | Yahoo Finance (yahoo-finance2) |
| News | NewsAPI.org (100 req/day) |
| AI Analysis | Google Gemini 2.5 Flash (250 req/day) |
| Email | Resend.com (3,000/month) |
| Telegram | Telegram Bot API |
| Scheduler | GitHub Actions (cron) |

Getting Started

1. Fork this repo
2. Add secrets (CONFIG_JSON, RESEND_API_KEY, RECIPIENT_EMAIL)
3. Run manually or wait for the daily cron (8am AEST)

See the full documentation for setup details.