AI-powered tutor that explains any subject step-by-step in simple language and generates practice questions, giving under-resourced students access to personalized learning. Built for Global Innovation Build Challenge V2.
# EduBridge AI
AI-powered tutor that explains any subject step-by-step in simple language
and generates practice questions, giving under-resourced students access to
personalized learning without expensive tutoring.
Built for **Global Innovation Build Challenge V2 (GIBC V2)** — Track 03: Open.
## Problem
UNESCO estimates 250M+ children worldwide lack access to quality teaching,
especially in low-resource and rural areas. Private tutoring is expensive
and often unavailable. EduBridge AI gives every student with basic internet
access a patient, always-available AI tutor.
## Features
- Ask any question in any subject, get a grade-level-appropriate explanation
- AI auto-generates a practice question to test understanding
- Instant AI-checked feedback on practice answers
- Progress dashboard showing questions asked, accuracy, and subject breakdown
- Lightweight, low-bandwidth-friendly interface
## Tech Stack
- **Backend:** Flask (Python)
- **Database:** SQLite
- **AI:** Google Gemini API (gemini-2.0-flash)
- **Frontend:** HTML/CSS/JS + Chart.js for the dashboard
- **Deployment:** PythonAnywhere
## Setup Instructions (PythonAnywhere)
1. **Upload files**
Upload all files/folders (app.py, requirements.txt, init_db.py,
templates/, static/) into a new directory in your PythonAnywhere
Files tab, e.g. `/home/yourusername/edubridge/`.
2. **Get a free Gemini API key**
Go to
aistudio.google.com and create a free key.
3. **Open a Bash console on PythonAnywhere** and run:
```bash
cd edubridge
pip install --user -r requirements.txt
python3 init_db.py
```
4. **Set your API key.** Easiest way: open `app.py` and replace
`PUT_YOUR_GEMINI_API_KEY_HERE` with your actual key on the line:
```python
GEMINI_API_KEY = os.environ.get("GEMINI_API_KEY", "PUT_YOUR_GEMINI_API_KEY_HERE")
```
5. **Configure the Web app tab** on PythonAnywhere:
- Create a new web app → Manual configuration → Python 3.10
- Set the **source code** directory to `/home/yourusername/edubridge` …