Skip to content

learnhouse/learnhouse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,726 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 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.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 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.