Skip to content

Repository files navigation

LearnHouse

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

LicenseStarsCLI VersionAPI CoverageLast CommitIssuesPull Requests

📖 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

Next.jsReactTypeScriptTailwindCSSRadix UITiptapCodeMirrorYjsFastAPIPythonPostgreSQLRedisDockerStripeGeminiLlamaIndexAWS S3Tinybird

📁 Project Structure

AppPathDescriptionTechnologyUsed by
Webapps/webFrontend application — dashboard, course player, editor, landing pagesNext.js, React, TailwindCSS, TiptapTeachers, Students, Admins
APIapps/apiBackend REST API — auth, courses, payments, AI, analyticsFastAPI, Python, SQLModel, AlembicWeb, CLI, Collab
Collabapps/collabReal-time collaboration server — live editing sync for courses & boardsHocuspocus, Yjs, WebSocketWeb (editor, boards)
CLIapps/cliOfficial CLI — setup wizard, dev environment, instance managementCommander, Node.jsDevelopers, Self-hosters

💬 Community

🤝 Contributing

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

🔒 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.

About

The Next-gen Open Source learning platform for everyone ✨

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages