Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -10,4 +10,41 @@ pinned: false
|
|
| 10 |
license: mit
|
| 11 |
---
|
| 12 |
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
license: mit
|
| 11 |
---
|
| 12 |
|
| 13 |
+
# π AI-Powered Exam Generator System
|
| 14 |
+
|
| 15 |
+
A complete multi-agent system for generating structured question papers, answer keys, and OBE summary reports using Groq API and Gradio.
|
| 16 |
+
|
| 17 |
+
## π Features
|
| 18 |
+
|
| 19 |
+
- **Multi-Agent Architecture**: Three specialized AI agents for generation, verification, and formatting
|
| 20 |
+
- **OBE Compliance**: Automatic Outcome-Based Education reporting
|
| 21 |
+
- **Real-time Updates**: Incorporates recent developments using SerpAPI
|
| 22 |
+
- **Stream-specific Templates**: CSE (MAANGO BIG15) vs Non-CSE (GATE patterns)
|
| 23 |
+
- **DOCX Export**: Professional document generation
|
| 24 |
+
- **Gradio UI**: User-friendly interface deployable on Hugging Face Spaces
|
| 25 |
+
|
| 26 |
+
## ποΈ System Architecture
|
| 27 |
+
|
| 28 |
+
### Agents:
|
| 29 |
+
1. **Generator** (Llama 3.1 70B): Creates structured question papers
|
| 30 |
+
2. **Verifier** (Gemma 2 27B): Validates quality and standards
|
| 31 |
+
3. **Formatter** (Mixtral-8x7B): Produces final outputs and answers
|
| 32 |
+
|
| 33 |
+
### Outputs:
|
| 34 |
+
- Question Paper (.docx)
|
| 35 |
+
- Model Answer Key (.docx)
|
| 36 |
+
- OBE Summary Report (.docx)
|
| 37 |
+
|
| 38 |
+
## π Quick Start
|
| 39 |
+
|
| 40 |
+
### Prerequisites
|
| 41 |
+
- Python 3.8+
|
| 42 |
+
- Groq API Key
|
| 43 |
+
- SerpAPI Key (optional)
|
| 44 |
+
|
| 45 |
+
### Installation
|
| 46 |
+
|
| 47 |
+
1. Clone the repository:
|
| 48 |
+
```bash
|
| 49 |
+
git clone <repository-url>
|
| 50 |
+
cd exam-generator-system
|