Richfolio

Zero-maintenance portfolio monitor with AI buy signals β€” runs free on GitHub Actions

TypeScript πŸ“„ ISC ⭐ …
Screenshot of Richfolio

Feature Image

Richfolio is a zero-maintenance portfolio monitoring system that sends daily email + Telegram briefings with allocation gaps, AI-powered buy recommendations, limit order prices, technical signals, and relevant news. It doesn’t pick stocks for you β€” you bring your own portfolio of stocks, ETFs, or crypto, and it tells you when to buy based on valuation, technicals, news sentiment, and allocation drift.

Setup takes ~10 minutes: fork the repo, register a few free API accounts (Resend, NewsAPI, Google Gemini), paste the keys into GitHub Settings, and define your target allocations in a JSON config. That’s it β€” no server, no dashboard, no coding required. Everything runs on a GitHub Actions cron job at $0/month.

Under the hood it uses Yahoo Finance for prices, fundamentals, and technicals (SMA, RSI, momentum), NewsAPI for headlines, and Google Gemini 2.5 Flash for AI analysis β€” including value ratings (ROE, debt/equity, FCF), bottom-fishing detection (oversold + volume contraction), and suggested limit order prices at nearby support levels. You also get a weekly rebalancing report, intraday alerts when signals strengthen, and a refresh mode for after-hours re-analysis.

Built it because I wanted a smart portfolio assistant that costs nothing, requires zero maintenance, and actually helps me time my buys better.

Daily Brief Intraday Alert Weekly Rebalance STRONG BUY Analysis