MCPcopy
hub / github.com/learnhouse/learnhouse

github.com/learnhouse/learnhouse @cli-1.5.1 sqlite

repository ↗ · DeepWiki ↗ · release cli-1.5.1 ↗
10,722 symbols 46,592 edges 1,430 files 2,254 documented · 21%
README

LearnHouse

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

License Stars CLI Version API Coverage 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.

Extension points exported contracts — how you extend this code

EELicenseDetail (Interface)
Shape of the FastAPI detail for a deactivated EE license.
apps/web/components/Admin/EELicenseError.tsx
SetupConfig (Interface)
(no doc)
apps/cli/src/types.ts
Org (Interface)
(no doc)
apps/e2e/core/client.ts
InstanceInfo (Interface)
(no doc)
apps/web/proxy.ts
LearnHouseConfigJson (Interface)
(no doc)
apps/cli/src/types.ts
SharedStudent (Interface)
(no doc)
apps/e2e/core/sharedAuth.ts
ResolvedTenant (Interface)
(no doc)
apps/web/proxy.ts
TextOptions (Interface)
(no doc)
apps/cli/src/utils/prompt.ts

Core symbols most depended-on inside this repo

t
called by 4286
apps/api/src/services/email/translations.py
error
called by 701
apps/web/components/Objects/StyledElements/Toast/ExportToast.tsx
commit
called by 687
apps/web/ee/services/scorm/ScormRuntimeAPI.ts
getAPIUrl
called by 454
apps/web/services/config/config.ts
Field
called by 423
apps/web/components/Admin/CreateOrganizationModal.tsx
fetch
called by 391
apps/collab/src/index.ts
useLHSession
called by 280
apps/web/components/Contexts/LHSessionContext.tsx
filter
called by 278
apps/e2e/features/assignments/pages/teacher.ts

Shape

Function 5,824
Method 2,775
Class 1,055
Interface 585
Route 483

Languages

Python62%
TypeScript38%

Modules by API surface

apps/api/src/tests/admin/test_admin_api.py232 symbols
apps/api/src/tests/services/test_assignments_service.py131 symbols
apps/api/src/routers/admin.py116 symbols
apps/api/src/routers/orgs/orgs.py92 symbols
apps/api/src/tests/services/test_short_answer_matching_edge.py86 symbols
apps/api/src/tests/services/test_courses_service.py75 symbols
apps/api/src/tests/security/test_resource_access.py71 symbols
apps/api/src/tests/services/test_assignment_grading.py70 symbols
apps/api/src/tests/services/test_number_answer_edge.py69 symbols
apps/api/src/tests/services/test_certifications_service.py61 symbols
apps/api/src/routers/courses/assignments.py61 symbols
apps/api/src/tests/services/test_form_grading_edge.py57 symbols

Dependencies from manifests, versioned

@clack/core1.0.1 · 1×
@clack/prompts1.0.0 · 1×
@codemirror/autocomplete6.18.4 · 1×
@codemirror/lang-cpp6.0.3 · 1×
@codemirror/lang-go6.0.1 · 1×
@codemirror/lang-java6.0.2 · 1×
@codemirror/lang-javascript6.2.4 · 1×
@codemirror/lang-markdown6.5.0 · 1×
@codemirror/lang-php6.0.2 · 1×
@codemirror/lang-python6.2.1 · 1×
@codemirror/lang-rust6.0.2 · 1×
@codemirror/lang-sass6.0.2 · 1×

Datastores touched

learnhouseDatabase · 1 repos
dbDatabase · 1 repos
lhDatabase · 1 repos
(mysql)Database · 1 repos
appDatabase · 1 repos

For agents

$ claude mcp add learnhouse \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact