AI-powered portfolio analytics platform for Indian retail investors
🎯 Demo Login — Email:
demo@portsense.in· Password:Demo@1234
Holdings reset on each demo login — feel free to add, edit, or delete anything.
Most Indian retail investors track their portfolio in Excel or rely on broker apps that show P&L and nothing else. PortSense goes further — it runs your holdings through a FinBERT NLP pipeline for real-time sentiment analysis using fresh GNews articles, computes portfolio beta and diversification scores, benchmarks your returns against Nifty 50 using XIRR, and uses Gemini 2.5 Flash to generate specific, rupee-amount rebalancing advice grounded in your actual data.
It supports NSE stocks, mutual funds (via MFAPI), and fixed deposits — three asset classes in one unified analytics platform.
Correlation Heatmap |
What If? Comparison |
FinBERT Sentiment Analysis |
Tax & Real Returns |
- JWT authentication with demo mode (auto-reset on every login)
- Holdings CRUD — Stocks (NSE), Mutual Funds, Fixed Deposits
- Live P&L dashboard — per-holding breakdown, today's change, portfolio summary
- NSE ticker typeahead search, MFAPI mutual fund search with active fund filtering
- Watchlist for stocks and mutual funds with live prices and sentiment badges
- Sector Breakdown — pie chart with overweight concentration warnings. MF and FD shown as separate categories, never grouped under "Others"
- Beta Analysis — portfolio beta vs per-stock beta breakdown table
- Diversification Score — composite 0–10 score across sector, size, and correlation sub-scores
- Benchmark Comparison — XIRR-based line chart vs Nifty 50 across full holding period. Includes MF and FD in portfolio valuation
- Stress Test — 6 preset market crash scenarios + custom shock input with horizontal bar visualization
- Risk Decomposition — systematic vs idiosyncratic vs sector concentration risk split
- Correlation Heatmap — pairwise matrix with color-coded cells. Top pairs explicitly show both strongly positive and negative correlations
- FinBERT Sentiment — ProsusAI/finbert scores headlines per stock using real-time GNews articles (2–7 day freshness window, tier-based per stock coverage). Aggregates to portfolio signal (Bullish/Bearish/Mixed). Collapse/expand per stock showing scored headlines with source name, date, and clickable article URL. Stocks with no recent news show "No recent articles — Sentiment defaulted to Neutral" rather than stale or misleading scores
- Gemini Rebalancing Advisor — grounded in live beta, diversification, sector weights, benchmark CAGR, and correlation pairs. Returns structured advice with specific rupee amounts per action across stocks, MFs, and FDs
- Gemini Correlation Explainer — explains why two stocks move together or apart using fundamental business reasoning
- Stock Intel Drawer — tabbed drawer (Snapshot / Technicals / Sentiment / Fundamentals / AI Analysis) with progressive reveal and TTL caching
- MF Info Drawer — 30-day NAV sparkline, historical returns (1W / 1M / 3M / 1Y)
- What If? Comparison — compares your portfolio against Gold, Silver, Nifty 50, FD, and Nifty Index Fund using identical cash flows and buy dates. MF NAV and FD compound interest included in portfolio valuation
- Tax & Real Returns — LTCG/STCG classification with ₹1.25L exemption, FD slab rate, MF debt vs equity treatment, inflation-adjusted real returns per holding
- Market News Feed — 13 category filters (Market, Banking, IT, Pharma, Auto, Energy, Finance, Mutual Funds, IPO, Economy, SEBI, Govt Policy, Rupee) powered by GNews API with article thumbnails, descriptions, and source attribution. Falls back to Google RSS if GNews is unavailable
- Account Page — Portfolio Health Score (0–100 derived from beta stability, diversification, sector balance), Holding Since stats, username and password change
| Layer | Technology | Reason |
|---|---|---|
| Frontend | React + Vite | Fast HMR, lightweight bundle |
| Charts | Recharts | Composable, works well with React state |
| Backend | FastAPI + Python | Async-native, automatic OpenAPI docs |
| Database | MongoDB Atlas + Motor | Flexible schema for mixed asset types |
| Auth | JWT (python-jose) | Stateless, works cleanly with demo mode |
| Stock Data | yfinance | Free, covers all NSE/BSE tickers |
| MF Data | MFAPI.in | Free Indian MF NAV API, no auth required |
| Sentiment | FinBERT via HuggingFace Inference API | Finance-domain BERT, outperforms general models on financial text |
| AI | Gemini 2.5 Flash (3-key rotation) | Low latency, generous free tier |
| News | GNews API (student access) + Google RSS fallback | Real-time Indian financial news with verified timestamps and source attribution |
| Deployment | Render (backend) + Vercel (frontend) | Free tier, auto-deploy on push |
Why FinBERT over VADER or TextBlob?
General sentiment models treat "the stock fell 5% as expected after results" as negative. FinBERT was trained on financial communications and correctly classifies these as neutral. It scores per-headline and aggregates via majority vote with confidence scoring.
Why GNews API over Google RSS for sentiment?
Google News RSS has no guaranteed freshness — despite the &tbs=qdr:w parameter, articles from 3 months ago routinely appear for active NSE stocks. FinBERT scoring stale headlines produces sentiment badges that reflect last month's market mood, not today's. GNews student API provides verified publishedAt timestamps and Indian-sourced articles (NDTV Profit, Economic Times, Moneycontrol). A tiered freshness window is applied — 2 days for heavily covered large-caps (TCS, INFY, HDFCBANK), 5 days for mid-caps, 7 days for defence and railway stocks — balancing recency against coverage depth.
Why show "No recent articles" instead of hiding the card?
Hiding a stock card when no fresh news exists implies the stock doesn't need attention. Showing the card with an explicit "No recent articles — Sentiment defaulted to Neutral" message is more honest and helps the investor understand the confidence level of the signal.
Why avoid stock price prediction?
Price prediction requires clean labeled data, significant compute, and still underperforms random walk on short horizons. PortSense focuses on explainability — beta, diversification, correlation — metrics an investor can actually act on. This design choice was deliberate.
Why three Gemini API keys in rotation?
The free tier enforces per-minute rate limits. Three keys in itertools.cycle distributes load, making cold-start failures on the rebalancing advisor rare without any paid tier.
Why sequential FinBERT calls instead of batch?
HuggingFace's free inference API binds to the event loop on batch calls, causing thread-safety issues with FastAPI's async executor. Sequential calls via ThreadPoolExecutor with asyncio.to_thread sidesteps this entirely with no performance loss on the free tier.
Why a single batch yfinance call for beta?
Concurrent yf.download calls share underlying urllib3 connection pools and produce race conditions under asyncio. A single call with multiple tickers is thread-safe and faster.
Asset type separation throughout
Every analytics route filters by assetType before passing tickers to yfinance. MF scheme codes and FD bank names never reach yfinance — they route to MFAPI and a compound interest formula respectively. This required fixes across 8 route files.
3-tier sector detection
MongoDB cache → yfinance .info → Gemini fallback. 33 tickers pre-seeded. MF and FD are short-circuited to "Mutual Fund" and "Fixed Deposit" labels before any API call, preventing them from appearing as "Others" in the sector breakdown.
Analytics and sentiment prefetching
After the Dashboard loads, analytics endpoints are prefetched silently after 3 seconds, and sentiment after 6 seconds. This ensures near-instant load times when the user navigates to those pages, trading one extra GNews quota call per session for a significantly better experience.
The demo portfolio is deliberately constructed to showcase every analytics feature:
| Group | Holdings | Purpose |
|---|---|---|
| IT cluster | TCS, INFY, HCLTECH | Strong positive correlation (0.93–0.97), triggers sector concentration warning |
| Defence | HAL, BEL | Low correlation with IT, government capex driven |
| FMCG | HINDUNILVR, ITC | Negative correlation with IT and metals (−0.4 to −0.5) |
| Energy | ONGC, RELIANCE | Strong negative correlation with IT (−0.78 to −0.83) |
| Banking | HDFCBANK, ICICIBANK | Moderate positive, high beta |
| Metal | TATASTEEL, JSWSTEEL | Cyclical, negative correlation with pharma |
| Railway/Infra | IRCTC, LT | PSU capex cycle, low correlation with private IT |
| Pharma | SUNPHARMA, DRREDDY | Defensive, negative correlation with cyclicals |
| Holding periods | Mix of pre-2024, Aug 2025, Jan 2026 buys | Demonstrates LTCG, STCG, and near-LTCG tax classification |
| Assets | 2 equity MFs, 1 debt MF, 2 FDs | Multi-asset type coverage across all features |
- Python 3.11+
- Node.js 18+
- MongoDB Atlas account (free tier)
- HuggingFace API key (free)
- Gemini API keys × 3 (free tier)
- GNews API key (free tier at gnews.io)
cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
# Create .env
cp .env.example .env
# Fill in: MONGO_URI, HF_API_KEY, GEMINI_API_KEY_1/2/3,
# JWT_SECRET, GNEWS_STUDENT_KEY, GNEWS_PERSONAL_KEY
# Seed demo data
python seed.py
# Run
uvicorn app.main:app --reloadcd frontend
npm install
echo "VITE_API_BASE_URL=http://localhost:8000" > .env
npm run devAPI docs at http://localhost:8000/docs
PortSense/
├── backend/
│ ├── app/
│ │ ├── routes/
│ │ │ ├── auth.py
│ │ │ ├── holdings.py
│ │ │ ├── analytics.py
│ │ │ ├── genai.py
│ │ │ ├── sentiment.py
│ │ │ ├── market.py
│ │ │ ├── watchlist.py
│ │ │ ├── news.py
│ │ │ ├── comparison.py
│ │ │ └── tax_returns.py
│ │ ├── services/
│ │ │ ├── analytics.py
│ │ │ ├── gemini.py
│ │ │ ├── sentiment.py
│ │ │ ├── market.py
│ │ │ ├── mf.py
│ │ │ ├── risk_decomposition.py
│ │ │ ├── technical.py
│ │ │ ├── cache.py
│ │ │ └── concurrency.py
│ │ ├── models/
│ │ │ └── holding.py
│ │ └── config/
│ │ └── db.py
│ └── seed.py
└── frontend/
└── src/
├── pages/
│ ├── Dashboard.jsx
│ ├── Analytics.jsx
│ ├── Tax.jsx
│ ├── Comparison.jsx
│ ├── SentimentPage.jsx
│ ├── Account.jsx
│ ├── NewsPage.jsx
│ └── Landing.jsx
├── components/
│ ├── StockIntelDrawer.jsx
│ ├── TopNav.jsx
│ ├── BottomNav.jsx
│ └── DemoBanner.jsx
├── hooks/
│ └── useSwipe.js
└── context/
└── AuthContext.jsx
- Bond support as a first-class asset type (coupon-based, not compound)
- Historical MF NAV per month in What If? timeline (currently uses current NAV as proxy)
- Portfolio export to PDF
- Price alerts via email for watchlist items
- Multi-currency support for NRI investors
- SSE streaming for sentiment progressive card reveal (currently blocked by ad-blocker heuristics on fetch endpoints)
Tax estimates are indicative only. Sentiment analysis and rebalancing advice are AI-generated and do not constitute financial advice. News articles are sourced via GNews API — PortSense does not own or modify any article content. Always attribute the original publisher when sharing. Consult a SEBI-registered investment advisor before making investment decisions.
Built with FastAPI · React · FinBERT · Gemini 2.5 Flash · GNews API
Deployed on Render + Vercel · Data from NSE via yfinance + MFAPI