https://github.com/learnhouse/learnhouse
The Next-gen Open Source learning platform for everyone ✨
https://github.com/learnhouse/learnhouse
ai ai-powered api cms education educational headless learning lms platforms python react
Last synced: 20 days ago
JSON representation
The Next-gen Open Source learning platform for everyone ✨
- Host: GitHub
- URL: https://github.com/learnhouse/learnhouse
- Owner: learnhouse
- License: agpl-3.0
- Created: 2022-05-10T21:10:28.000Z (almost 4 years ago)
- Default Branch: dev
- Last Pushed: 2026-03-11T20:30:32.000Z (20 days ago)
- Last Synced: 2026-03-11T20:31:47.955Z (20 days ago)
- Topics: ai, ai-powered, api, cms, education, educational, headless, learning, lms, platforms, python, react
- Language: TypeScript
- Homepage: https://learnhouse.app
- Size: 22.7 MB
- Stars: 1,321
- Watchers: 9
- Forks: 246
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
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
```bash
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.
```bash
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
```bash
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](apps/cli/README.md) 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](https://discord.gg/CMyZjjYZ6x) — chat with the team and other users
- [Documentation](https://docs.learnhouse.app) — guides and references
## 🤝 Contributing
```bash
git clone https://github.com/learnhouse/learnhouse.git
cd learnhouse
npx learnhouse dev
```
- [Contributing Guide](CONTRIBUTING.md)
- [Submit a bug](https://github.com/learnhouse/learnhouse/issues/new?assignees=&labels=bug%2Ctriage&projects=&template=bug.yml&title=%5BBug%5D%3A+)
- [Good first issues](https://github.com/learnhouse/learnhouse/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)
## 🔒 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](https://learnhouse.app/security) for details on our practices, scope, and responsible disclosure guidelines.
## ✍️ Author & Maintainer
Sweave (Badr B.) — [@swve](https://github.com/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](LICENSE) — Enterprise features are available under a separate Enterprise License.