kussssh/IPO-Analyzer

IPO Analysis

FastAPI-based IPO analysis platform for SEBI DRHP, RHP, and Prospectus filings.

What It Does

• —Scrapes SEBI filing catalogs for DRHP, RHP, and Prospectus
• —Builds a searchable company tracker
• —Downloads and parses filing PDFs
• —Runs 8 analysis modules with gpt-5-nano
• —Stores catalog and analysis cache locally in SQLite
• —Serves a built-in frontend from the FastAPI app

Local Run

1. Create environment

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. Configure environment

Copy .env.example to .env and set:

GEMMA_API_KEY=your_gemma_api_key_here

3. Start the app

uvicorn backend.api:app --host 0.0.0.0 --port 8000

Open http://127.0.0.1:8000.

GitHub Push

git init
git branch -M main
git remote add origin https://github.com/K-u-s-h-gupta/IPO-Analysis.git
git add .
git commit -m "Initial commit"
git push -u origin main

Important Deployment Note

GitHub can host the source code, but it cannot run this FastAPI backend by itself.

For a live deployed app, use:

• —Render
• —Railway
• —Fly.io

GitHub should be used as the repository, and one of the platforms above should run the app.

Recommended Deployment: Render

1. 1.Push this repo to GitHub.
2. 2.Go to Render.
3. 3.Create a new Web Service.
4. 4.Connect the GitHub repo.
5. 5.Use:

Build command:

pip install -r requirements.txt

Start command:

uvicorn backend.api:app --host 0.0.0.0 --port $PORT

Set environment variable:

• —GEMMA_API_KEY

Project Structure

• —backend/ FastAPI app, scraper, parser, retriever, modules
• —frontend/ HTML/CSS/JS app served by FastAPI
• —uploads/ downloaded PDFs and local working files
• —outputs/ generated analysis JSON

Runtime Entry Point

backend.api:app