The next-gen open-source platform for world-class educational content.

📖 Courses — Create and manage courses with ease
✏️ Editor — Powerful block-based Notion-like content editor
📦 Collections — Organize courses into curated bundles
📝 Assignments — Create tasks and track student submissions
💬 Discussions — Community forums for your learners
🎙️ Podcasts — Audio content for on-the-go learning
📊 Analytics — Track engagement and course performance
🧊 Playgrounds — AI-generated interactive elements, simulations & diagrams
💻 Code — Real code execution with auto-grading in 30+ languages
📋 Boards — Real-time collaborative whiteboards
🧠 AI — Context-aware AI for learning & teaching
🎓 Certificates — Auto-generate certificates on course completion
👥 User Groups — Organize learners and control access
🔍 SEO — Built-in SEO optimization with metadata, sitemaps & open graph
🎨 Customization — Custom branding, landing pages & theming
💳 Payments (Enterprise) — Sell courses with no fees and no lock-in
🔐 SSO (Enterprise) — Single sign-on with OAuth providers
🏢 Multi-Org (Enterprise) — Run multiple organizations from a single instance

🚀 Get Started

LearnHouse has an official CLI that handles everything — self-hosting, updates, backups, and local development.

Self-host

npx learnhouse@latest setup

The setup wizard walks you through domain, database, admin account, and optional features. Once done, it generates all config files and starts your instance.

npx learnhouse start       # Start services
npx learnhouse stop        # Stop services
npx learnhouse update      # Update to latest version
npx learnhouse logs        # Stream logs
npx learnhouse backup      # Backup database
npx learnhouse doctor      # Diagnose issues

Development

git clone https://github.com/learnhouse/learnhouse.git
cd learnhouse
npx learnhouse dev

This spins up PostgreSQL and Redis, installs dependencies, and starts the API, Web, and Collab servers with hot reload.

See the full CLI documentation for all commands and options.

🛠️ Tech Stack

📁 Project Structure

App	Path	Description	Technology	Used by
Web	apps/web	Frontend application — dashboard, course player, editor, landing pages	Next.js, React, TailwindCSS, Tiptap	Teachers, Students, Admins
API	apps/api	Backend REST API — auth, courses, payments, AI, analytics	FastAPI, Python, SQLModel, Alembic	Web, CLI, Collab
Collab	apps/collab	Real-time collaboration server — live editing sync for courses & boards	Hocuspocus, Yjs, WebSocket	Web (editor, boards)
CLI	apps/cli	Official CLI — setup wizard, dev environment, instance management	Commander, Node.js	Developers, Self-hosters

💬 Community

• Discord — chat with the team and other users
• Documentation — guides and references

🤝 Contributing

git clone https://github.com/learnhouse/learnhouse.git
cd learnhouse
npx learnhouse dev

• Contributing Guide
• Submit a bug
• Good first issues

🔒 Security

We take the security of LearnHouse and the data entrusted to us seriously. If you discover a vulnerability, please email security@learnhouse.app — do not disclose it publicly until we've had a chance to investigate.

Please include a clear description, steps to reproduce, affected endpoints, and any relevant screenshots or proof-of-concept code. We will acknowledge your report, keep you informed, and credit you once resolved if you wish.

See our full Security Policy for details on our practices, scope, and responsible disclosure guidelines.

✍️ Author & Maintainer

Sweave (Badr B.) — @swve

💜 A Word

LearnHouse is made with 💜, from the UI to the features it is carefully designed to make students and teachers lives easier and make education software more enjoyable.

Thank you and have fun using/developing/testing LearnHouse !

📄 License

AGPL-3.0 — Enterprise features are available under a separate Enterprise License.