selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

mosoo logo

Self-host mosoo

v0.7.0

API-first managed runtime for coding agents

AlphaOpen SourceApache-2.0
Updatedlast week
LanguageTypescript
Setup difficultyAdvanced
Stars
166
Ports
8787 (API Worker), 5173 (Console (Web Worker))
Requires
Cloudflare Containers, Cloudflare D1, Cloudflare Durable Objects, Cloudflare Queues, Cloudflare R2, Cloudflare Workers, Docker
Install with Cloudflare Workers

What is mosoo?

An open-source runtime that lets your backend run coding agents through one API. Each job gets its own sandbox that keeps working files and conversation history between turns. The platform handles execution, sandboxing, checkpoints, live event streams, and usage metrics while your app controls business logic and user auth. It runs on Cloudflare's platform and you supply your own model API keys. Still in Alpha so APIs may shift. To self-host you need a Cloudflare account with those services plus a domain on Cloudflare DNS; local dev uses bun, just, and Docker.

Should you self-host mosoo?

mosoo scores 42/100 on selfhost.directory (how scoring works) and ranks #163 of 209 in AI Agents. It has 166 GitHub stars.

It shipped 8 stable releases in the past year. The latest, v0.7.0, came out on 10 October 2026. New versions land roughly every 4 days.

Setup is advanced: plan for several services and some ongoing maintenance. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Orca (91/100, 108 739 stars). It scores higher overall, so compare the two before you pick. See mosoo vs Orca side by side.

Features

  • Agent Presets
  • Bring-your-own model keys
  • Environments
  • Event Streaming (SSE)
  • Isolated Sandboxes
  • Managed Files
  • Project-based Multi-tenancy
  • Skills and MCP Servers
  • Tool Streaming
  • Unified Agent API
  • Usage Tracking

mosoo README

How to install mosoo

Install mosoo with Cloudflare Workers

Deploy mosoo with Cloudflare Workers from GitHub Actions or a local Wrangler toolchain.

mosoo runs as two Cloudflare Workers: an API Worker backed by D1, R2, Queues, Durable Objects, and Containers, plus a Web Worker that serves the console and binds to the API service.

This guide covers the two deployment paths used by the reference deployment:

  • Cloud deployment — GitHub Actions builds and publishes to Cloudflare.
  • Local toolchain deployment — an operator publishes the same configuration with Wrangler from a local checkout.

Both paths use apps/api/wrangler.toml, apps/web/wrangler.toml, and the repository deployment scripts. Prepare the Cloudflare resources once, then choose either release path.

Requires Cloudflare account with Workers, D1, R2, Queues, Durable Objects, and Containers

How to configure mosoo

  • AUTH_EMAIL_FROMmosoo AUTH <auth@mosoo.ai>Email sender for auth emails

    Email sender for auth emails

  • BACKUP_BUCKET_NAMEmosoo-sandbox-stateR2 bucket name for sandbox state backups

    R2 bucket name for sandbox state backups

  • BETTER_AUTH_SECRETSecret for Better Auth authentication

    Secret for Better Auth authentication

  • CLOUDFLARE_ACCOUNT_IDCloudflare account ID

    Cloudflare account ID

  • FILE_BUCKET_NAMEmosoo-fileR2 bucket name for files

    R2 bucket name for files

  • MOSOO_API_DEV_DOCKER_HOSTDocker host for local development

    Docker host for local development

  • MOSOO_API_DEV_USE_DEFAULT_DOCKERUse default Docker host

    Use default Docker host

  • MOSOO_ENVIRONMENTdevelopmentEnvironment name

    Environment name

  • MOSOO_RUNTIME_IMAGES_ENABLEDfalseEnable runtime images

    Enable runtime images

  • POSTHOG_API_HOSThttps://us.i.posthog.comPostHog API host for analytics

    PostHog API host for analytics

  • R2_ACCESS_KEY_IDR2 access key ID for object storage

    R2 access key ID for object storage

  • R2_SECRET_ACCESS_KEYR2 secret access key for object storage

    R2 secret access key for object storage

  • RUNTIME_ACTION_TOKEN_SECRETSecret for runtime action tokens

    Secret for runtime action tokens

  • VAULT_ROOT_SECRETRoot secret for vault encryption

    Root secret for vault encryption

  • WEB_ORIGINhttp://localhost:5173Web origin for CORS and auth

    Web origin for CORS and auth

mosoo releases & version history

More in API Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…