/Gpt5_JEE_problem_solver

This is a streamlit app that takes an image of a jee advanced level question and generates a structured solution with simailar practice questions .

Primary LanguagePython

📚 JEE Advanced Problem Solver & Analyzer

A lightning-fast, AI-powered assistant that dissects JEE Advanced problems straight from an image, powered by GPT-5 + Educhain.

Python 3.13+ Streamlit OpenAI Educhain License

🌟 Features

  • 📸 Image Upload: Drop a JEE Advanced image
  • 🔍 Topic Extraction: Instantly see all concepts involved
  • 🧮 Step-by-Step Solution: High-detail, exam-grade explanations
  • 🐳 Similar practice problems: 5 new problems which use similar concept as the given problem
  • ⚙️ GPT-5 Engine: state-of-the-art reasoning

🚀 Quick Start

1. Clone & Enter

git clone https://github.com/<your-org>/jee-gpt5-solver.git
cd jee-gpt5-solver

2. Install Dependencies

# Using pip
pip install -r requirements.txt

# or modern Python
pip install .

Requirements are Python ≥3.13.
uv venv or standard venv is recommended.

3. Launch Streamlit

streamlit run app.py

Your browser will open at http://localhost:8501.

🔐 Configure OpenAI Key

  • In the sidebar paste your OpenAI API Key (Have credits ready; GPT-5 usage applies).
  • The key is never stored—it only lives in memory during the session.

📷 How It Works

  1. Menu (left): Enter API key
  2. Center: Drop an image (jpg, png, jpeg)
  3. Click “Analyze Problem”
    → Topics appear as 🟢 bullets
    → Complete solution auto-expands below

🛠️ Tech Stack

Layer Tech
LLM Engine GPT-5 via langchain-openai
Orchestration Educhain (educhain)
UI Streamlit (responsive, light & dark modes)
Image Support Pillow (PIL)
Packaging pyproject.toml → pip,uv

🤝 Contributing

Contributions welcome!

  1. Fork the repo
  2. Create a feature branch
  3. poetry run pytest (if tests exist)
  4. Open a pull request 🎉

If you spot bugs, open an Issue — attach sample images for faster triage.

📜 License

MIT © 2024 Build Fast with AI.

Built with ❤️ by Build Fast with AI