Skip to content

learnhouse/learnhouse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,654 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LearnHouse

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

License Stars CLI Version Last Commit Issues Pull 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 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.js React TypeScript TailwindCSS Radix UI Tiptap CodeMirror Yjs FastAPI Python PostgreSQL Redis Docker Stripe Gemini LlamaIndex AWS S3 Tinybird

📁 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

🤝 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 [email protected] — 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.

Packages

 
 
 

Contributors