Apppublic

tisha04/EDUFLOW

sourceHugging Facemitupdated 6mo agoView on Hugging Face

0likes

App README

🎯 ExamEdge AI — Smart Exam Study Planner

AI-powered timetable manager for competitive exam candidates (JEE, NEET, UPSC, GATE, CAT, etc.)

Features

—AI-generated daily study plans personalised to your exam goal and daily hours
—Subject memory — tracks completion rate per subject, flags weak areas automatically
—Daily adaptation agent — detects missed sessions, reschedules tasks, rebalances load
—Productivity dashboard — progress score, per-subject bars, session history

Tech Stack

—Frontend: Gradio
—AI: Groq API (LLaMA 3.3 70B — fast & free)
—DB: SQLite (local, persistent within the Space)

Deploy on Hugging Face Spaces

1.Create a new Space → SDK: Gradio
2.Upload all files (or push via git)
3.Go to Settings → Variables and secrets → New secret:

   Name:  GROQ_API_KEY
   Value: gsk_...

1.Space restarts automatically — you're live!

Local Setup

bash

pip install -r requirements.txt
export GROQ_API_KEY=gsk_...
python app.py

File Structure

app.py          ← Gradio UI (all tabs, event wiring)
llm.py          ← Groq API wrapper (call_groq, parse_json_response)
planner.py      ← AI schedule generator
agent.py        ← Daily adaptation agent
memory.py       ← Per-subject learning memory
database.py     ← SQLite setup & helpers
requirements.txt
README.md

Bugs Fixed vs Original Codebase

#	Bug	Fix
1 & 2	`from prompts.templates` — no such package	`from templates import ...`
3	DB path used `".."` — navigated outside project	Fixed to project-local `__file__` path
4	Invalid model string `claude-opus-4-6`	Switched to Groq `llama-3.3-70b-versatile`
5	JSON fallback `end` could be `0` → crash	Added guard `end > start`
6	Hardcoded `localhost:8000` FastAPI URL	Removed FastAPI; all logic in-process
7	Missing API key silently passed as `""`	Raises `ValueError` at startup