Python 3.14+ · BSL 1.1 · Source Available

What if your company had infinite, tireless employees?

A Python framework for building synthetic organizations -- autonomous AI agents with real roles, personalities, budgets, memory, and enterprise-grade governance. Define a company in YAML. Watch it run.

Early Access -- SynthOrg is under active development. Some features shown are planned but not yet fully implemented. Follow on GitHub ยท Get in touch

Type-Safe Async-First Protocol-Driven Provider-Agnostic 100+ LLM Providers Enterprise Security

See How It Works

Set up a full AI organization in minutes -- from a solo builder to a 30+ agent enterprise.

setup wizard
Choose a template

  Solo Builder       2 agents   2 depts
  Tech Startup       5 agents   3 depts
  Engineering Squad  8 agents   3 depts
  Product Studio     10 agents  5 depts
▶ Agency             12 agents  5 depts
  Research Lab       7 agents   3 depts
  Enterprise Org     30+ agents 9 depts

Or define your own with YAML config.

9 built-in templates from 2 to 30+ agents. Fully customizable roles, personalities, budgets, and tools.

REST API
POST /api/v1/setup/company
  template: "agency"
  company_name: "Acme AI Lab"

201 Created
  agents_created: 12
  departments:
    - Operations    (PM, Scrum Master)
    - Engineering   (3 developers)
    - Design        (UX, UI)
    - QA            (QA Engineer)
    - Creative      (Writer, Strategist)

Setup wizard or REST API. Auto-assigns LLM models, generates agent names, configures tool access.

activity log
[TASK]  #12 created: "Redesign checkout flow"
[ENGINE] PM decomposed #12 into 4 subtasks
[ENGINE] #12a -> UX Designer (role-based)
[ENGINE] #12b -> Backend Dev (load-balanced)
[ENGINE] #12c -> Frontend Dev (role-based)
[ENGINE] #12d -> QA Engineer (role-based)
[COMMS]  UX Designer -> PM: "Wireframes ready"
[DONE]  #12a approved by PM (quality: 94%)
[COMMS]  Meeting: sprint review (round-robin)

DAG-based decomposition. 6 routing strategies. Meetings, delegation, and conflict resolution built in.

dashboard
Agents active:       12 across 5 departments
Tasks completed:     47
Total cost:          EUR 18.92
Coordination overhead: 14% (healthy)
Budget remaining:    EUR 81.08 / 100.00

Top Performers:
  Backend Dev    quality: 95%  tasks: 11  cost: EUR 3.20
  UX Designer    quality: 93%  tasks:  8  cost: EUR 2.15
  PM             quality: 91%  tasks:  9  cost: EUR 4.80

Per-token cost tracking. Coordination overhead. Performance scoring. Budget enforcement at every layer.

What Makes SynthOrg Different

Not just agent orchestration -- a complete organizational system with HR, governance, personality-driven teams, and enterprise-grade cost controls.

Architecture

Modular, protocol-driven. Every component is pluggable.

Explore full architecture →

Use Cases

AI Dev Team

CTO + Engineers + QA. Autonomous software development with code review, testing, and deployment pipelines.

  • DAG-based task decomposition
  • Git tools + code sandbox
  • Three-tier quality scoring

Research Organization

Director + Analysts + Reviewers. Literature review, data analysis, and collaborative report generation.

  • Memory retrieval pipeline
  • Hybrid search (dense + BM25)
  • Automated consolidation

Content Pipeline

Editor + Writers + Fact-checkers. Content creation with editorial oversight, review cycles, and quality control.

  • Meeting-based coordination
  • Conflict resolution protocols
  • Approval gate workflows

Customer Support

Manager + Agents + Escalation. Tiered handling with knowledge sharing and automatic performance tracking.

  • Hierarchical delegation
  • Shared knowledge base
  • Performance scoring

Security Operations

SecOps lead + Analysts + Incident responders. Automated scanning, threat assessment, and coordinated response.

  • Progressive trust levels
  • Persistent audit trails
  • Sandboxed tool execution

Data Analytics

Lead Analyst + Data Engineers + Visualization specialists. End-to-end analysis pipelines with budget tracking.

  • Multi-project support
  • Automated reporting
  • Per-token cost tracking

See the Dashboard

Monitor agents, tasks, budgets, and communications in real time -- all from a single dashboard.

Acme AI LabRunning
7 agents12 tasks

License & Usage

SynthOrg uses the Business Source License 1.1 -- source available, production-friendly for most users, converting to Apache 2.0 automatically.

Always Free

  • Personal learning and experimentation
  • Academic and research use
  • Development, testing, and evaluation
  • Contributing to SynthOrg itself

Free in Production

  • Organizations with <500 employees and contractors (including affiliates)
  • Non-competing use: internal tools, automation, or products where SynthOrg is not the core value
  • No separate license needed -- see LICENSE for full terms

Commercial License

  • Organizations with 500+ employees
  • Offering SynthOrg as a hosted service
  • Reselling or embedding as core product
  • May be granted at no cost -- just ask

Every version converts to Apache 2.0 automatically. We welcome feedback on the license -- start a discussion or open an issue.

Read the full licensing rationale →

Build something that thinks like a team.

Get Started

Get in Touch

Questions about licensing, commercial use, or the framework? We'd love to hear from you.