README.md

---
title: SNS
emoji: 👁
colorFrom: indigo
colorTo: gray
sdk: gradio
sdk_version: 6.0.0
app_file: app.py
pinned: false
license: mit
---

# 🚀 AI-Powered Exam Generator System

A complete multi-agent system for generating structured question papers, answer keys, and OBE summary reports using Groq API and Gradio.

## 🌟 Features

- **Multi-Agent Architecture**: Three specialized AI agents for generation, verification, and formatting
- **OBE Compliance**: Automatic Outcome-Based Education reporting
- **Real-time Updates**: Incorporates recent developments using SerpAPI
- **Stream-specific Templates**: CSE (MAANGO BIG15) vs Non-CSE (GATE patterns)
- **DOCX Export**: Professional document generation
- **Gradio UI**: User-friendly interface deployable on Hugging Face Spaces

## 🏗️ System Architecture

### Agents:
1. **Generator** (Llama 3.1 70B): Creates structured question papers
2. **Verifier** (Gemma 2 27B): Validates quality and standards
3. **Formatter** (Mixtral-8x7B): Produces final outputs and answers

### Outputs:
- Question Paper (.docx)
- Model Answer Key (.docx) 
- OBE Summary Report (.docx)

## 🚀 Quick Start

### Prerequisites
- Python 3.8+
- Groq API Key
- SerpAPI Key (optional)

### Installation

1. Clone the repository:
```bash
git clone <repository-url>
cd exam-generator-system