Ludwitt
An open-source adaptive learning platform. Clone it, self-host it, run your own instance.
Ludwitt is a learning platform that moves students through a structured progression: from K-12 foundations, through hands-on developer training, into professional work and university-level research. It's built with Next.js, Firebase, and Anthropic Claude, and it's released under the AGPL-3.0 so anyone can run, modify, and deploy their own instance.
If you run a modified version as a network service, you share your changes back. That's the deal.
What It Looks Like
Screenshots coming soon. No live demo yet — Ludwitt requires Firebase and Anthropic credentials to run. Clone it and try it locally with the Quick Start below.
How It Works
Students advance through four gated stages. Each one unlocks the next.
1. Basics -- K-12 Foundations
Six adaptive subjects: Math, Reading, Logic, Latin, Greek, Writing. Difficulty adjusts automatically based on recent performance. Problems come from a local store, Firebase, or are generated on-demand by AI.
Includes gamification (XP, streaks, achievements, leaderboards, virtual companions), cohort-based group learning with mentors, live study rooms, writing competitions, and AI-generated independent study tracks.
Unlocks ALC at: Math Grade 12 + Reading Grade 12 + 5,000 XP/week.
2. ALC -- Accelerated Learning Center
Project-based developer training. Students set up real tools, build real projects, and ship to production.
Three paths: Cursor (AI code editor), Claude Code (CLI agent), OpenClaw (open-source agent). Each path ends with a deployed personal website and 5 portfolio projects. Every portfolio item requires a Brainlift (written process doc), a Loom video walkthrough, and a live production URL.
Unlocks Developer/University at: 5 completed projects + verified deployment.
3. Developer Portal
Professional client work. Developers claim documents from customers, manage multi-developer projects with milestones and budgets, track revenue, and communicate through per-document messaging. Includes productivity tools (focus mode, time tracking, goals) and team features (workload distribution, leaderboard).
4. University
Advanced coursework and research, unlocked alongside the Developer Portal. Pick any topic and get an AI-generated learning path with courses and deliverables (apps, simulations, research tools). Includes peer reviews, guided exploration with an AI teaching assistant, a skills graph, digital credentials, and a university-level portfolio.
Customer Portal
The other side of the Developer Portal. Customers submit Google Docs, approve work, track projects, and communicate with developers. Documents flow through: pending, approved, in-progress, completed, accepted.
Self-Hosting
Ludwitt is designed to be self-hosted. You bring your own:
- Firebase project -- Firestore, Auth, Storage
- Anthropic API key -- Powers all AI features (grading, explanations, generation)
- Stripe account -- Subscriptions and credit purchases (optional)
- Vercel account -- Deployment (or any Node.js host)
See the Setup Guide for full instructions.
Quick Start
git clone https://github.com/rogerSuperBuilderAlpha/ludwitt-openclaw.git
cd ludwitt-openclaw
npm install
cp .env.example .env.local # Add your Firebase, Anthropic, and Stripe credentials
npm run dev
Open http://localhost:3000.
Tech Stack
| Layer | Technologies |
|---|
| Frontend | Next.js 16 (App Router), React 19, TypeScript 5.9, Tailwind 4 |
| Backend | Next.js API Routes, Firebase Admin SDK |
| Database | Firebase Firestore |
| Auth | Firebase Authentication |
| AI | Anthropic Claude (token-based credit system) |
| Payments | Stripe (subscriptions + credits) |
| Video | Daily.co (study rooms) |
| Testing | Jest 30, Playwright |
Project Structure
ludwitt-openclaw/
├── src/
│ ├── app/ # Next.js App Router (pages + API routes)
│ │ ├── basics/ # K-12 learning
│ │ ├── alc/ # Accelerated Learning Center
│ │ ├── university/ # University-level learning
│ │ ├── customers/ # Customer portal
│ │ ├── developers/ # Developer dashboard
│ │ └── api/ # API routes
│ ├── components/ # React components by feature
│ ├── lib/ # Core logic (basics engine, progression gates, credits, AI, Stripe)
│ └── data/ # Static curriculum and problem sets
├── docs/ # Documentation
├── e2e/ # Playwright E2E tests
└── scripts/ # Utility scripts
Scripts
npm run dev # Development server
npm run build # Production build
npm run lint # ESLint
npm run type-check # TypeScript checking
npm run test # Unit tests (Jest)
npm run test:e2e # E2E tests (Playwright)
npm run seed:basics # Seed problem sets to Firestore
Documentation
Contributing
We welcome contributions. See CONTRIBUTING.md for the full workflow, but the short version:
- Fork the repo
- Create a branch (
feature/, fix/, docs/)
- Make your changes, run
npm run lint && npm run test && npm run build
- Open a PR
Please read the Code of Conduct before contributing.
Community
Contributors
Thanks to everyone who contributes to Ludwitt. See CONTRIBUTING.md to get started.
License
AGPL-3.0 -- (c) 2025-2026 Ludwitt
You're free to use, modify, and deploy Ludwitt. If you run a modified version as a network service (i.e., users interact with it over a network), you must make your modified source code available under the same license. See the full license text for details.
