Eminence-Pyro/3MTT-Compass-AI

🧭 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 …