README.md

---
title: Flask Question Generation API
emoji: 🎓
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
---

# Flask ML API - Question Generation

AI-powered API for generating educational questions from study content.

## Features

- 🤖 **BiGNN Classification** - Classifies sentences for MCQ vs Theory questions
- ✨ **Gemini AI Generation** - Generates 40 MCQs + 20 Theory questions
- 📝 **NLTK Tokenization** - Smart sentence splitting
- ⚡ **Fast Processing** - 60-90 second response time

## API Endpoints

### Health Check
```bash
GET /health
```

### Generate Questions
```bash
POST /api/restructure/
Content-Type: application/json

{
  "content": "Your educational content here..."
}
```

## Usage Example

```bash
curl -X POST https://YOUR-SPACE-NAME.hf.space/api/restructure/ \
  -H "Content-Type: application/json" \
  -d '{"content": "Your study content..."}'
```

## Technical Stack

- Flask + PyTorch + BiGNN + Gemini AI + NLTK + Gunicorn

---

Built with ❤️ for educational technology