q-simplified / README.md
Deployment Agent
Fix short_description length
4493ab3
metadata
title: Q-Simplified
emoji: πŸ“ˆ
colorFrom: blue
colorTo: red
sdk: docker
pinned: false
license: mit
short_description: The Financial Architect β€” Live market data & blogs

Q-Simplified β€” The Financial Architect

A full-stack financial education platform with:

  • Live market data β€” Sensex, Nifty 50, USD/INR, Crude Oil, Repo Rate, CPI (refreshed every 60s)
  • Trending blogs β€” Deep-dive financial analysis simplified for modern investors
  • Live news β€” RSS-scraped headlines from ET, Moneycontrol, LiveMint
  • Study Zone β€” Financial courses for every level
  • Auth system β€” Register, login, JWT sessions

Environment Variables (optional β€” app works in demo mode without these)

Set these in your Space's Settings β†’ Repository secrets:

Variable Description
SUPABASE_URL Your Supabase project URL
SUPABASE_SERVICE_KEY Supabase service role key (Settings β†’ API)
JWT_SECRET Any random 32+ character string

Without Supabase, the app runs in demo mode with static blog data and a temporary in-memory user store.

Tech Stack

  • Backend: FastAPI (Python) β€” single process, all microservices combined
  • Frontend: Vanilla HTML/CSS/JS β€” no build step needed
  • Data: Live RSS scraping + Yahoo Finance API (free, no key needed)
  • Database: Supabase (optional) / in-memory demo mode
  • Fonts: Manrope + Work Sans (Google Fonts)

Pages

  • / β€” Homepage with indicators, featured blog, live insights
  • /trends β€” Full market data with interactive Chart.js charts
  • /study-zone β€” Course catalog with category filters
  • /login β€” Auth with register + forgot password
  • /api/docs β€” FastAPI Swagger UI

Local Development

git clone https://huggingface.co/spaces/YOUR_USERNAME/q-simplified
cd q-simplified
pip install -r requirements.txt
python app.py
# Open http://localhost:7860