An adaptive, AI-tutored, self-hosted platform for learning to code (and later, ML / deep learning / building LLMs from scratch).
LearnPro hosts a containerized in-browser sandbox where you write and run code in many languages, while an LLM-backed agentic harness builds an evolving profile of your skills, pace, strengths, and gaps — and uses it to plan your next session, day, week, and long-term mastery roadmap. Adaptive problem difficulty, hint laddering, gamified progress, and (eventually) voice-driven "think-aloud" tutoring make it feel like a real teacher who actually knows you.
Self-hosted-first, open-source under BSL 1.1 (auto-converts to Apache 2.0 in 2030). SaaS later.
MVP build — foundation phase. The monorepo skeleton + dev Docker stack are live (STORY-052). Application features land Story-by-Story per the board.
Prerequisites: Node 20+ (pnpm enforced via packageManager), pnpm 9, Docker Desktop with the WSL2 backend on Windows (or Docker Engine on Linux/Mac).
# 1. Install dependencies (creates .pnpm-store + node_modules — both gitignored)
pnpm install
# 2. Start the local dev stack (Postgres+pgvector / Redis / MinIO / Piston)
docker compose -f infra/docker/docker-compose.dev.yaml up -d
# 3. Boot apps/web (port 3000) and apps/api (port 4000)
pnpm devSmoke check:
Single-command Windows variant:
./scripts/windows/dev-up.ps1(Mac / Linux: ./scripts/mac/dev-up.sh or ./scripts/linux/dev-up.sh.)
- Vision (verbatim user input):
docs/vision/RAW_VISION.md - Groomed feature catalog:
docs/vision/GROOMED_FEATURES.md - Architecture & ADRs:
docs/architecture/ - MVP scope:
docs/roadmap/MVP.md - Roadmap (MVP → v1 → v2 → v3):
docs/roadmap/ROADMAP.md - Live status board (Epics / Stories / Tasks):
project/BOARD.md - For Claude Code sessions:
CLAUDE.md
Next.js 15 + React 19 + TypeScript · Node.js (Fastify) · Postgres + pgvector + Redis · Self-hosted Piston sandbox in Docker on WSL2 · Anthropic Claude (behind a LLMProvider interface) · pnpm workspaces + Turborepo monorepo.
Windows-first development; Mac/Linux supported via OS adapters. Browser app today → PWA in v1 → iOS/Android (Capacitor) in v2.
Business Source License 1.1. Free to self-host for personal, team, school, or internal company use. Hosting LearnPro as a paid service to third parties is not permitted until the Change Date (2030-04-25), at which point this code converts to Apache License 2.0.