marimohub is a self-hostable platform for storing, managing, and running marimo notebooks. It is built for teams that want to run notebooks on their own infrastructure while choosing their own storage, compute, and identity providers.
The hub has no separate database. Notebook metadata, versions, snapshots, and system records live in an object store, so the object store is the source of truth you back up and recover. External systems sit behind TypeScript ports, so operators can swap providers without changing the domain logic.
- Bring your own storage: CoreWeave CAIOS, S3-compatible storage, Google Cloud Storage, Azure Blob Storage, filesystem, or Cloudflare R2.
- Bring your own compute: CoreWeave Sandboxes, Modal, Kubernetes, Docker, Podman, E2B, Cloudflare Containers, or local subprocesses.
- Bring your own identity: OpenID Connect or Cloudflare Access.
- Optional managed AI, versioned integrations, encrypted values, external secret references, and short-lived federated cloud access.
Use marimohub when you want a self-hosted notebook hub with a small operational surface and explicit provider choices. If you want a hosted SaaS or do not want to operate storage, compute, and auth, this is probably not the right shape yet.
Requirements: Node >= 24, pnpm 10.20.0, and uv plus Python if you want to
start local notebook kernels.
pnpm install --frozen-lockfile
pnpm devpnpm dev watches the TypeScript server and runs it with the Vite web app in
parallel. It skips the production server build. The local stack uses:
memorystorage, which is non-durablelocalcompute, which startsuv run marimo editdevauth, which signs everyone in as a fixed local super admin- integrations and metadata browsing, with a welcome notebook and sample environment
Set MARIMOHUB_DEV_PERSIST=true to keep local state in the Git-ignored
.context/dev-storage directory. Run pnpm dev:reset after stopping the dev
stack to clear it.
See Testing locally for the full local path and the production swaps for each backend.
Most deployments use the config-driven server image: set MARIMOHUB_*
environment variables and let @marimo-hub/config select the adapters. Custom
runtimes can compose the packages directly as a library.
Start with Getting started, then choose a deployment guide:
Useful references:
- Configuration - every
MARIMOHUB_*variable - Storage, Compute, and Auth - backend choices
- Security, Operations, and Troubleshooting - production operation
- API & client - HTTP response envelope and generated client
This is a pnpm and vite-plus TypeScript monorepo.
pnpm check
pnpm test
pnpm buildRead CONTRIBUTING.md before opening a pull request. For architecture and internal design, start with development_docs/architecture.md and development_docs/bucket_spec.md. Integration kind contributors should also read development_docs/integrations.md.
marimohub is licensed under the Apache License, Version 2.0. See LICENSE.