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 subsystem libraries are built and tested; the agent runtime that makes the organisation execute work is in active development.

Honest status: the agent runtime is in active development

The platform, dashboard, CLI, persistence, and subsystem libraries are built and tested. The autonomous agent runtime that runs the organisation end to end is not yet wired and is the focus of current work. 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, since the agent runtime is in active development.

  • Design Overview

    Vision, principles, core concepts, and glossary.

    Design Overview

  • Agents & HR

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

    Agents

  • Organization & Templates

    Company types, hierarchy, departments, template system.

    Organization

  • 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 (designed)

These describe the designed system. The provider layer is shipped; the others are built and unit-tested as components and run via the agent runtime, which is in active development (see the Roadmap).

  • Agent Orchestration: agents with roles, models, and tools; designed task decomposition, routing, and collaboration.
  • Budget Enforcement: designed per-agent cost limits, auto-downgrade to cheaper models, spending reports, and CFO-level cost optimisation.
  • Security & Trust: designed SecOps agent, fail-closed rule engine, progressive trust, autonomy levels, and audit logging.
  • Memory: designed per-agent and shared organisational memory with retrieval pipeline, consolidation, and archival.
  • Communication: designed message bus, delegation, conflict resolution, and meeting protocols.
  • HR Engine: designed 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 (available now): 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, organized 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