# Quants Suite - Portfolio Analysis Suite

Comprehensive web interface combining multiple quantitative analysis tools: QRep portfolio performance, security performance reports, AI technical analysis, financial data, and historical prices. Built with Google AI Studio, connects to multiple FastAPI-MCP backend servers.

## Links
- App: https://portfolio-iframe.tigzig.com
- Docs: https://tigzig.com/app-documentation/portfolio-analysis-suite.html
- GitHub (Frontend): https://github.com/amararun/shared-portfolio-analysis-googleui

## Tags
portfolio-analysis, quantstats, technical-analysis, mcp, react

## Architecture

```
React Frontend (Google AI Studio built) → Multiple FastAPI-MCP Backends
├── QuantStats Server (quantstats.hosting.tigzig.com)
├── SPR/FFN Server (ffn.hosting.tigzig.com)
├── Technical Analysis Server
└── Yahoo Finance Server (yfin.hosting.tigzig.com)
```

- Frontend: React + TypeScript + TailwindCSS, deployed on Vercel/Netlify
- Each backend exposes API endpoints independently (no n8n orchestration - direct API calls)

### Suite Components

**QRep Report** - QuantStats-based performance analysis: daily/monthly/yearly returns, Sharpe/Sortino ratios, max drawdown, rolling stats, benchmark comparison (SPY, custom).

**Security Performance Report** - Custom calculations + FFN library: performance stats, drawdown analysis, return distributions, risk-adjusted returns. Multi-symbol support.

**AI Technical Analysis** - Technical indicators (RSI, MACD, Bollinger Bands), support/resistance levels, trend analysis, AI interpretation via Gemini Vision API.

**Financials & Prices** - Historical price data, financial statements, key ratios, company information from Yahoo Finance.

### Supported Symbols
Any Yahoo Finance symbol: stocks (AAPL, MSFT), ETFs (SPY, QQQ), crypto (BTC-USD), commodities (GC=F), currencies (EURUSD=X).

## Setup

```bash
git clone https://github.com/amararun/shared-portfolio-analysis-googleui.git
npm install
npm run dev
```

Requires backend servers to be running. See backend documentation:
- QuantStats: https://tigzig.com/mcp-server-quantstats
- Technical Analysis: https://tigzig.com/mcp-server-technical-analysis
- Yahoo Finance: https://tigzig.com/mcp-server-yahoo-finance
- SPR/FFN: https://tigzig.com/mcp-server-ffn