Skip to content

SynthOrg Documentation

An autonomous product studio you operate: a self-hostable platform where a synthetic organisation of role-based AI agents is designed to plan and deliver products under budgets and governance.

SynthOrg lets you define agents with roles, hierarchy, budgets, and tools as a virtual organisation. The platform, infrastructure, and runtime are built and tested; the agent runtime, multi-agent coordinator, and work pipeline are wired and exercised by deterministic e2e harnesses. Operator-facing maturity and real-provider acceptance are the focus of current work.

Honest status: pre-alpha

SynthOrg is pre-alpha. The platform, dashboard, CLI, persistence, provider layer, agent runtime, multi-agent coordinator, work pipeline spine, intake engine, sandbox lifecycle dispatch, and distributed-path consumers are all wired and exercised by deterministic e2e harnesses with a scripted provider (no real LLM spend). Operator-facing onboarding against a real provider and real workloads has not been exercised end to end by a human. Design-specification pages describe intended behaviour and mark per-area status; treat any gap between a spec and the code as the work, not the spec. See the Roadmap for exactly what is available now versus in active development.

Get Started

  • Use SynthOrg

    Pick a template and stand up the SynthOrg platform via Docker.

    User Guide

  • Develop SynthOrg

    Clone the repo, set up your dev environment, and contribute.

    Developer Setup

  • Guides

    In-depth guides for configuration, agents, budgets, security, deployment, and more.

    Guides

Design Specification

The design spec covers the full intended architecture of SynthOrg, from agent identity to budget enforcement. It is the source of truth for designed behaviour; each area marks its current wiring status as operator-facing maturity lands.

  • Design Overview

    Vision, principles, core concepts, and glossary.

    Design Overview

  • Agents & HR

    Agent identity, roles, hiring, performance tracking, promotions.

    Agents

  • Organisation & Templates

    Company types, hierarchy, departments, template system.

    Organisation

  • Communication

    Message bus, delegation, conflict resolution, meeting protocols.

    Communication

  • Task & Workflow Engine

    Task lifecycle, execution loops, routing, recovery, shutdown.

    Engine

  • Memory & Persistence

    Memory types, backends, retrieval pipeline, operational data.

    Memory

  • Providers & Cost

    LLM providers, budget, tools, security.

    Providers

Key capabilities

These run today, exercised by deterministic e2e harnesses with a scripted provider; real-provider acceptance and operator polish are in flight (see the Roadmap).

  • Agent Orchestration: agents with roles, models, and tools; task decomposition, routing, and collaboration through the multi-agent coordinator and work pipeline spine.
  • Budget Enforcement: per-agent cost limits, auto-downgrade to cheaper models, spending reports, and CFO-level cost optimisation.
  • Security & Trust: SecOps agent, fail-closed rule engine, progressive trust, autonomy levels, and audit logging.
  • Memory: per-agent and shared organisational memory with retrieval pipeline, consolidation, and archival.
  • Communication: message bus, delegation, conflict resolution, and meeting protocols.
  • HR Engine: hiring, firing, onboarding, offboarding, performance tracking, and promotion criteria.
  • Tool Integration: built-in tools (file system, git, sandbox, code runner) plus an MCP bridge for external tools.
  • LLM Providers: provider-agnostic via LiteLLM, with routing strategies, retry/rate-limiting, and capability matching.

Further Reading

Section Description
Architecture System overview, module map, design principles
Tech Stack Technology choices and engineering conventions
Decision Log All design decisions, organised by domain
REST API REST + WebSocket API reference (Scalar/OpenAPI)
Library Reference Auto-generated from docstrings
Roadmap Status, open questions, future vision
  • GitHub Repository
  • License (BUSL 1.1, source available; free production use for non-competing small organisations; converts to Apache 2.0 at the Change Date)
  • Licensing & Usage: what is permitted, why BUSL, and how to get a commercial license