An AI-powered personalized tutor and learning companion designed specifically for high school students in Africa. Built with Flask, OpenAI GPT-4o, and modern web technologies.
# SmartLearn - AI-Powered Lea**Prerequisites:** Python 3.7+, pip, OpenAI API key
### 💻 Run Locally
#### 1. Clone & Setupng Companion
> Transforming education in Africa through personalized AI tutoring, interactive quizzes, and intelligent learning analytics.
🌍 **Live Demo** | 📊 **Pitch Deck** | 🚀 **GitHub**
An AI-powered personalized tutor and learning companion designed specifically for high school students in Africa. Built with Flask, OpenAI GPT-4o, Firebase, and modern web technologies.
## ✨ What Makes SmartLearn Special?
- 🤖 **AI-Powered Tutoring**: Get personalized help with any subject using GPT-4o
- 🌍 **Africa-First Design**: Content aligned with KCSE, WAEC, and African curricula
- 🎯 **Interactive Quizzes**: AI-generated practice questions with instant feedback
- 📊 **Smart Analytics**: Track progress, identify strengths, and discover learning gaps
- 💡 **Personalized Learning**: AI recommendations based on your unique learning journey
- 🏆 **Premium Features**: Unlimited quiz generation and advanced analytics
- 🔒 **Secure Payments**: Integrated with IntaSend for seamless premium upgrades
- 📱 **Modern UI**: Clean, responsive design optimized for all devices
## 🎯 Quick Start
Ready to experience AI-powered learning?
### 🌐 Try the Live Demo
**Launch SmartLearn →**
### 📊 Explore Our Vision
**View Pitch Deck →**
### � Run Locally
### 1. Clone the Repository
```bash
git clone
github.com
cd smartlearn
```
#### 2. Environment Setup
```bash
# Windows
python -m venv venv
venv\Scripts\activate
# macOS/Linux
python3 -m venv venv
source venv/bin/activate
```
#### 3. Install Dependencies
```bash
pip install -r requirements.txt
```
#### 4. Configure Environment
Create `.env` file:
```env
# OpenAI API Key (REQUIRED for AI features)
OPENAI_API_KEY=your-openai-api-key-here
# Flask Configuration
SECRET_KEY=your-secret-key-here
# Payment Integration (IntaSend)
INTASEND_SECRET_KEY=sk_test_xxx
INTASEND_PUBLIC_KEY=pk_test_xxx
I …