README.md

---
title: AI Tutor — Study / Review
emoji: 🎓
colorFrom: gray
colorTo: blue
sdk: streamlit
sdk_version: "1.37.1"   # 和你的 requirements 里 streamlit 版本一致或略低
app_file: src/streamlit_app.py        # 你的入口文件名；如果不是 app.py 就改成对应名字
pinned: false
---

# GitHub Tutor (GPT-5) — Hackathon Space

## How to run locally
```bash
pip install -r requirements.txt
$env:AIML_API_KEY="8b7b1b6b0f3143448bb1374e243e7091"
streamlit run app.py
```

## Deploy to Hugging Face Spaces
1. Create account → New Space → **SDK: Streamlit**.
2. Upload `app.py`, `requirements.txt`, `questions.json`.
3. In Space → **Settings → Variables and secrets**:
   - Add `OPENAI_API_KEY` with your GPT-5 key.
4. Click **Restart** if needed; open the app URL.

## Notes
- The file system is ephemeral. Summaries are kept in session only (demo-friendly).
- Edit `questions.json` to add/remove problems for the demo.