Eminence-Pyro/3MTT-Compass-AI
Domain:
educationnatural language processingRecord type:
software
Creator:
Emi
Host:
🧭 AI-powered personalised learning companion for Nigeria's 3MTT program — Groq Llama 3.3, Flask, React, MongoDB
# 🧭 3MTT Compass AI — Personalised Learning Pathfinder
> **AI-powered learning companion for Nigeria's 3MTT program**
> React + TypeScript frontend · Flask + MongoDB backend · Groq Llama 3.3 AI
🔗 **Live:** 3mtt-compass-ai.vercel.app
🤖 **AI:** Groq Llama 3.3 70B (fast, free tier available)
---
## 🚀 What's Inside
| Feature | Status | Notes |
|---|---|---|
| 🤖 Compass AI Chat | ✅ Real AI | Groq Llama 3.3 · context-aware |
| 💡 Smart Recommendations | ✅ Real AI | Track + level personalised |
| 📊 AI Learning Insights | ✅ Real AI | Progress score, strengths, gaps |
| 🔍 Semantic Search | ✅ Real AI | Natural language content search |
| 🎯 Assessment Analysis | ✅ Real AI | AI determines skill level |
| 🌐 Landing Page | ✅ New | Public homepage before login |
| 🔐 JWT Auth | ✅ Live | MongoDB Atlas |
| 📚 12 Learning Tracks | ✅ | All 3MTT tracks covered |
| 🏆 Achievement System | ✅ | Points, badges, milestones |
---
## ⚙️ Environment Variables (Required)
### Backend (`backend/.env`)
```
MONGO_URI=mongodb+srv:// : @cluster.mongodb.net
SECRET_KEY=your-long-random-jwt-secret
GROQ_API_KEY=gsk_xxxxxxxxxxxx
FLASK_ENV=production
```
### Frontend (`.env.local`)
```
VITE_API_URL=your-backend.onrender.com
```
> ⚠️ **IMPORTANT:** Never commit `.env` files. The `.gitignore` now excludes them.
---
## 🔑 Getting Your Keys
**Groq API Key (free):**
1. Go to console.groq.com
2. Sign up → API Keys → Create new key
3. Copy and add to `backend/.env` as `GROQ_API_KEY`
**MongoDB Atlas:**
1. Go to cloud.mongodb.com
2. Create a free cluster
3. Connect → Drivers → Copy connection string
4. Replace ` ` and ` ` in the string
5. Add to `backend/.env` as `MONGO_URI`
> ⚠️ If your old MongoDB credentials were exposed, rotate them now:
> Atlas → Database Access → Edit user → Reset password
---
## 💻 Local Development
```bash
# 1. Clone
git clone github.com
cd 3MTT-Compass-AI
# 2. Frontend
npm install
cp .env.example .env.local
# Edit …