QuantRisk Pro

Prerequisites — Install These First

1. Python 3.10+ → https://www.python.org/downloads/

   • During install → CHECK "Add Python to PATH"
   • Verify: Open terminal → python --version

2. Node.js 18+ → https://nodejs.org/ (LTS version)

   • Verify: Open terminal → node --version

3. MongoDB Community Server → https://www.mongodb.com/try/download/community

   • Choose: Windows x64 → MSI package
   • During install:
     • Choose "Complete" install
     • CHECK "Install MongoDB as a Service"
   • After install MongoDB auto-starts on port 27017

---

How to Run

Open PowerShell or Command Prompt inside this folder.

Step 1: Install Python Packages

pip install -r requirements.txt

Step 2: Install Frontend Packages

cd 06_Frontend
npm install
cd ..

Step 3: Seed the Database (First Time Only)

cd 03_Core_Application
python migrate_to_mongo.py
cd ..

This creates a ready-to-use demo account and loads market data from CSV.

Step 4: Start Backend Server (Terminal 1)

cd 03_Core_Application
python -m uvicorn api:app --host 0.0.0.0 --port 8000 --reload

Keep this terminal open.

Step 5: Start Frontend Server (Terminal 2)

Open a new terminal in the project folder:

cd 06_Frontend
npm run dev

Keep this terminal open too.

Step 6: Open in Browser

http://localhost:5173/

Step 7: Login

Use the demo account:

Email:    demo@quantrisk.com
Password: demo123

Or register a new account with your own email.

---

Troubleshooting

Problem	Solution
python not found	Reinstall Python, CHECK "Add to PATH"
npm not found	Reinstall Node.js from https://nodejs.org/
MongoDB connection refused	Open Services (Win+R → services.msc) → Find "MongoDB Server" → Right click → Start
bcrypt error during migrate	Run: pip install bcrypt==4.0.1 then retry
Network Error in browser	Backend not running — start Terminal 1 first
Port 5173 already in use	Run: npx kill-port 5173 then restart frontend
Incorrect password on login	Use demo@quantrisk.com / demo123 or register a new account
Market data loading forever	Yahoo Finance may be blocked on your network — the app will use local data automatically

---

Tech Stack

Layer	Technology
Frontend	React 19, Vite, Recharts, Plotly
Backend	FastAPI, Python
Database	MongoDB
ML Models	XGBoost, GARCH, GJR-GARCH
Data Feed	Yahoo Finance (with offline fallback)

Ports

Service	Port	URL
Backend	8000	http://localhost:8000
Frontend	5173	http://localhost:5173
MongoDB	27017	mongodb://localhost:27017