Open Source Development
Repository Map
Understand the open source repository split in the Monkeys ecosystem
Monkeys is a multi-repository system. The monkeys repository is the ecosystem hub: it keeps deployment references, local compose files, architecture notes, and contribution guidance. Runtime source code lives in the owning repositories.
Core Product
| Repository | Responsibility |
|---|---|
monkeys | Ecosystem entrypoint, local infrastructure compose, service compose, architecture references, contribution guidance. |
monkeys-server | Main backend API, workflow API, service bus, model/tool integration, metrics, runtime modules. |
monkeys-studio | Main React/Vite Studio frontend for workflows, agents, tools, data, evaluations, and settings. |
monkeys-kernel | Platform management frontend. |
monkeys-compute | Compute control-plane frontend. |
Backend Capabilities
| Repository | Responsibility |
|---|---|
monkeys-agent-server | Agent runtime, threads, messages, tool calls, and agent-oriented execution. |
monkeys-billing-server | Usage metering, pricing, balance, billing records. |
monkeys-data-server | Data service module. |
monkeys-webhook-server | Webhook delivery and notification module. |
monkeys-mcp-server | MCP bridge for AI agents and coding tools. |
Tools And Workers
| Repository | Responsibility |
|---|---|
monkeys-conductor-worker | Worker process for Conductor task execution. |
monkeys-comfyui-worker | Worker process for ComfyUI queues and image execution. |
monkeys-training-worker | Worker process for model training queues. |
monkey-tools-third-party-api | Node.js third-party API tool service. |
monkey-tools-third-party-api-python | Python third-party API tool service. |
monkey-tools-sandbox | Tool sandbox runtime. |
monkey-tools-agentkits | Agent toolkits and reusable tool adapters. |
Contribution Rule Of Thumb
- Product UI changes usually belong in
monkeys-studio,monkeys-kernel, ormonkeys-compute. - Workflow, model, tool, API, auth, metrics, or persistence changes usually belong in
monkeys-server. - Agent-specific runtime changes usually belong in
monkeys-agent-server. - Deployment and ecosystem documentation changes usually belong in
monkeysormonkeys-docs. - Tool runtime changes belong in the specific
monkey-tools-*repository.