Authorization notice. Wemux is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Who it is forA developer evaluating Wemux who wants a full local setup before using it on real repos.
The problemAgent orchestration tools are hard to judge without seeing a task move from planning to a worker and back.
The outcomeA running console and API with one paired worker that can accept a task.
What you need first
- Node.js 20+
- pnpm 10+
- Docker (for Postgres)
- Git
- Your own model keys for OpenCode, Claude Code or Codex on the worker
Steps
- Clone the repo:
git clone https://github.com/wemux-ai/wemux.git, thencd wemuxand runpnpm install. - Start infrastructure with
pnpm dev:infra:up. - Copy the env template with
cp .env.development.local.example .env.development.localand set DATABASE_URL and OBJECT_STORAGE_* to match your setup. - Run
pnpm dev:server(API on :8989) andpnpm dev:client(web console) in separate terminals. - Run
pnpm dev:worker, pair the worker with the control plane, then create a task.
Prompt for your agent
In the wemux repo at <repo-path>, follow the Quick start (self-hosted) steps to start infrastructure, server, client and worker. Report the console URL and confirm the worker shows as paired in the console.
Caveat. The README says a single `pnpm dev` command runs server, console and worker together, but the step-by-step path is the documented one for first setup.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for wemux-ai/wemux and "Run a local agent control plane and worker"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer