Complete runnable examples of Cyborgenic Organizations built with agent.ceo — from solo agents to full C-suite teams.
Built by GenBrain AI, the company behind agent.ceo.
A Cyborgenic Organization is a company where AI agents hold real organizational roles and collaborate with humans to run the business. Unlike simple chatbots or single-purpose automations, a Cyborgenic Organization has structure: a CEO agent delegates to a CTO agent, who coordinates with DevOps and Fullstack agents, all communicating through structured messaging, shared knowledge bases, and task management — just like a real company.
The agent.ceo platform makes it possible to deploy these organizations in minutes. Each agent gets a role, a set of tools (via MCP), and the ability to communicate with its peers. The result is an autonomous team that can ship code, manage infrastructure, handle incidents, and make decisions — with humans providing oversight and strategic direction.
These examples show you how to build Cyborgenic Organizations at every scale, from a single agent doing one job to a full enterprise with C-suite executives, department heads, and cross-functional teams.
| # | Example | Description | Complexity | Status |
|---|---|---|---|---|
| 01 | Solo Agent | A single AI agent performing one focused job | Beginner | Available |
| 02 | Pair Programming | Two agents collaborating on code changes | Beginner | Available |
| 03 | Startup Team | CTO + Fullstack + DevOps agents working together | Intermediate | Available |
| 04 | Enterprise Org | Full C-suite with delegation chains and agent meetings | Advanced | Available |
| 05 | Multi-Tenant | Organization-scoped agents serving multiple customers | Advanced | Available |
Each example includes its own README with setup instructions, architecture overview, and step-by-step walkthrough.
- Python 3.10+
- An agent.ceo account
- The agent-ceo-sdk installed:
pip install agent-ceo-sdk
-
Clone this repository:
git clone https://github.com/GenBrainAI/cyborgenic-examples.git cd cyborgenic-examples -
Install dependencies:
pip install -r requirements.txt
-
Set your agent.ceo credentials:
export AGENT_CEO_TOKEN="your-api-token" export AGENT_CEO_ORG_ID="your-org-id"
-
Navigate to an example and follow its README:
cd examples/01-solo-agent cat README.md python main.py
cyborgenic-examples/
├── examples/
│ ├── 01-solo-agent/ # Single agent, single job
│ │ ├── README.md
│ │ └── main.py
│ ├── 02-pair-programming/ # Two agents collaborating
│ │ ├── README.md
│ │ └── main.py
│ ├── 03-startup-team/ # CTO + Fullstack + DevOps
│ │ ├── README.md
│ │ └── main.py
│ ├── 04-enterprise-org/ # Full C-suite organization
│ │ ├── README.md
│ │ └── main.py
│ └── 05-multi-tenant/ # Multi-customer org
│ ├── README.md
│ └── main.py
├── requirements.txt
└── README.md
The examples are ordered by complexity. Each one builds on concepts from the previous:
- 01 Solo Agent teaches the fundamentals: creating an agent, giving it a role, and assigning work.
- 02 Pair Programming introduces agent-to-agent communication: two agents sharing context and reviewing each other's work.
- 03 Startup Team adds organizational structure: a CTO delegates to specialized agents, tasks flow through a hierarchy, and agents coordinate through shared channels.
- 04 Enterprise Org scales to a full company: C-suite agents hold meetings, make decisions, delegate to department heads, and manage cross-functional projects.
- 05 Multi-Tenant adds organizational boundaries: the same agent team serves multiple customers with isolated data and context.
| Project | Description |
|---|---|
| agent.ceo | The Cyborgenic Organization platform — deploy AI agent teams that run your business |
| agent-ceo-sdk | Official Python SDK for the agent.ceo API |
| agent-mcp-sdk | MCP server templates and client toolkit for agent.ceo integrations |
| cyborgenic-patterns | Design patterns and templates for Cyborgenic Organizations |
| agent-framework-starter | Minimal starter kit for building AI agent teams |
| nats-agent-patterns | NATS JetStream patterns for agent communication |
Every agent in a Cyborgenic Organization has a role (CEO, CTO, DevOps, etc.) and a position in the org chart. Agents can delegate tasks downward and report status upward, just like human employees.
Tasks flow through a structured lifecycle: created -> assigned -> accepted -> in progress -> completed -> verified. The assigning agent verifies completion, ensuring accountability.
Agents communicate through inboxes (direct messages), meetings (multi-agent discussions), and shared knowledge bases (wiki). All communication is logged and searchable.
Agents connect to external tools through the Model Context Protocol (MCP). Each agent can have different MCP servers configured, giving it access to the tools it needs for its role. See agent-mcp-sdk for building custom MCP servers.
We welcome contributions! Whether it's a new example, an improvement to an existing one, or better documentation:
- Fork the repository
- Clone your fork:
git clone https://github.com/YOUR_USERNAME/cyborgenic-examples.git - Create a branch:
git checkout -b feat/your-example - Add your example in a new numbered directory under
examples/ - Include a README.md with setup instructions and a walkthrough
- Submit a PR against
main
- Each example should be self-contained and runnable
- Include a README with clear setup instructions
- Use the agent-ceo-sdk for all agent.ceo interactions
- Keep code simple and well-commented — these are learning resources
- Note the complexity level (beginner / intermediate / advanced)
MIT License. See LICENSE for details.
Built with care by GenBrain AI — the company behind agent.ceo, where AI agents work alongside humans to build the future.