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.

Wemux logo

Self-host Wemux

v0.3.130

AI agent collaboration platform with worker-first execution

BetaOpen SourceApache-2.0
Updatedlast week
LanguageTypescript
Setup difficultyAdvanced
Stars
167
Ports
8989 (control plane HTTP/WS API), 48100 (worker daemon API)
Requires
PostgreSQL, S3-compatible Object Storage
Install with Docker Compose

What is Wemux?

Wemux is an AI-native organization operating system that lets teams coordinate AI agents to perform actual coding tasks on machines they own. The control plane manages planning, routing, and review while agents operate in isolated Git worktrees on local or remote workers using bring-your-own-keys model configuration with OpenCode, Claude Code, or Codex. It includes kanban task boards, workspace sessions with real-time collaboration, a Drive for file sharing, and inbound channel integrations for Feishu, Slack, DingTalk, WeCom, WeChat, and WhatsApp. Workers run on macOS, Linux, or Windows via WSL and connect through a generated install command. The platform is fully self-hostable via Docker Compose with PostgreSQL and MinIO or Railway, with a React web console, Electron desktop app, and React Native mobile apps. The community edition is Apache-2.0 licensed; hosted model gateway, billing, and managed cloud nodes are separate commercial services.

Should you self-host Wemux?

Wemux scores 44/100 on selfhost.directory (how scoring works) and ranks #80 of 125 in AI. It has 167 GitHub stars.

It shipped 1 stable release in the past year. The latest, v0.3.130, came out on 3 September 2026.

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 ComfyUI (93/100, 143 752 stars). It scores higher overall, so compare the two before you pick. See Wemux vs ComfyUI side by side.

Features

  • Realtime Collaboration
  • Self-hosted cloud nodes
  • Usage dashboard

Wemux README

How to install Wemux

Install Wemux with Docker Compose

Docker + Docker Compose
Environment variables
POSTGRES_PASSWORD, OBJECT_STORAGE_SECRET_ACCESS_KEY, BETTER_AUTH_SECRET, TOKEN_SECRET, SECRET_ENCRYPTION_KEY, WEMUX_PUBLIC_BASE_URL, etc.

cp .env.production.example .env.production

编辑 .env.production 里的强密码与域名

docker compose -f docker-compose.production.yml --env-file .env.production up -d

Production stack with PostgreSQL, MinIO, and control-plane

How to configure Wemux

  • BETTER_AUTH_SECRETSecret for Better Auth (generate with openssl rand -hex 32)

    Secret for Better Auth (generate with openssl rand -hex 32)

  • BETTER_AUTH_URLPublic origin for auth callbacks

    Public origin for auth callbacks

  • CLOUDFLARE_ACCOUNT_IDCloudflare account ID for email

    Cloudflare account ID for email

  • CLOUDFLARE_API_TOKENCloudflare API token for email

    Cloudflare API token for email

  • DATABASE_URLPostgreSQL connection string

    PostgreSQL connection string

  • EMAIL_FROMFrom address for emails

    From address for emails

  • EMAIL_PROVIDEREmail provider for verification emails

    Email provider for verification emails

    values: cloudflare

  • GOOGLE_CLIENT_IDGoogle OAuth client ID

    Google OAuth client ID

  • GOOGLE_CLIENT_SECRETGoogle OAuth client secret

    Google OAuth client secret

  • HOST0.0.0.0Bind address

    Bind address

  • NODE_ENVdevelopmentEnvironment mode

    Environment mode

    values: development, production

  • OBJECT_STORAGE_ACCESS_KEY_IDObject storage access key

    Object storage access key

  • OBJECT_STORAGE_BUCKETBucket name for object storage

    Bucket name for object storage

  • OBJECT_STORAGE_ENDPOINTS3-compatible storage endpoint

    S3-compatible storage endpoint

  • OBJECT_STORAGE_REGIONus-east-1Object storage region

    Object storage region

  • OBJECT_STORAGE_SECRET_ACCESS_KEYObject storage secret key

    Object storage secret key

  • PORT8989Port for control plane (fallback 8989)

    Port for control plane (fallback 8989)

  • SECRET_ENCRYPTION_KEY32-byte hex key for encrypting secrets (generate with openssl rand -hex 32)

    32-byte hex key for encrypting secrets (generate with openssl rand -hex 32)

  • TOKEN_SECRETToken signing secret (generate with openssl rand -hex 32)

    Token signing secret (generate with openssl rand -hex 32)

  • TURNSTILE_SECRET_KEYCloudflare Turnstile secret key

    Cloudflare Turnstile secret key

  • TURNSTILE_SITE_KEYCloudflare Turnstile site key

    Cloudflare Turnstile site key

  • WEMUX_HEALTH_TOKENToken for detailed health endpoint access

    Token for detailed health endpoint access

  • WEMUX_MANAGED_CLOUD_ENABLEDEnable self-hosted cloud nodes

    Enable self-hosted cloud nodes

    values: 1

  • WEMUX_MANAGED_CLOUD_RUNTIME_PROVIDERRuntime provider for cloud nodes

    Runtime provider for cloud nodes

    values: docker-cli, boxlite-cli, ascii-box-cli, unsafe-local-process

  • WEMUX_PUBLIC_BASE_URLPublic origin URL for the control plane

    Public origin URL for the control plane

  • WEMUX_USAGE_REPORTING_DISABLEDDisable anonymous usage reporting (set to 1)

    Disable anonymous usage reporting (set to 1)

    values: 1

Wemux releases & version history

FAQ

Where can worker nodes run?

Workers can run on local Macs, Linux boxes, shared office machines, or cloud VMs — any online worker becomes schedulable execution capacity.

More in Task Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…