Learning Platform

An AI-powered interactive learning platform for SQL, MongoDB, programming languages, and more. It delivers adaptive learning paths, real-time feedback, and instructor tooling.

Features

• AI-generated slides, quizzes, and hints with multiple LLM providers
• Interactive learning sessions with progress tracking
• Admin dashboard for course and learner management
• YAML/JSON course definitions with versioning
• Caching and rate limiting for predictable API usage

Tech Stack

• Backend: FastAPI, SQLAlchemy 2, PostgreSQL, Redis, LangChain
• Frontend: React 18, Vite, TailwindCSS, Zustand, Monaco Editor
• Infrastructure: Docker, structured logging, auto-generated API docs

Quick Start

Prerequisites

• Python 3.10+
• Node.js 18+
• PostgreSQL 13+
• Redis 6+
• LLM API keys (OpenAI, Anthropic, or Groq)

Setup

Automated setup for backend and frontend:

git clone https://github.com/yourusername/learning-platform.git
cd learning-platform
chmod +x setup.sh
./setup.sh

Run

Start both backend and frontend:

chmod +x start.sh
./start.sh

Run separately if needed:

# Backend
cd backend
source venv/bin/activate
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# Frontend
cd frontend
npm run dev

Endpoints:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Configuration

Copy and edit the backend environment file:

cp backend/.env.example backend/.env

Key variables:

• LLM_PROVIDER (openai, anthropic, groq)
• OPENAI_API_KEY / ANTHROPIC_API_KEY / GROQ_API_KEY
• DATABASE_URL
• REDIS_URL
• SECRET_KEY

Project Structure

learning-platform/
├── backend/          # FastAPI backend
├── frontend/         # React + Vite frontend
├── docs/             # Documentation
├── setup.sh          # Setup script
├── start.sh          # Start script
└── README.md

API

See the interactive API documentation at http://localhost:8000/docs.

Testing

cd backend
source venv/bin/activate
pytest -v

Contributing

Please see CONTRIBUTING.md.

License

MIT. See LICENSE.