![\"OneManCompany\"](\"img/omc.png\")
\n\n \n
The AI Operating System for One-Person Companies
\n\n\n 中文文档 · Talent Market · Issues\n
\n\n> Others use AI to write code. You use AI to run a company.\n>\n> Linux runs servers. OneManCompany runs companies.\n>\n> Not building a company — building any company.\n\nOneManCompany is an open-source OS that lets anyone build and run a complete AI-powered company from their browser.\n\n**You are the CEO — the only human.** Everyone else — HR, COO, engineers, designers — are AI employees that think, collaborate, and deliver real work autonomously.\n\n🏢 **Real company management** — Yes, your AI employees have performance reviews. Yes, they get nervous.\n\n📈 **Gets better with use** — Your AI employees don't plateau. Every retrospective, performance review, and 1-on-1 coaching session becomes lasting work experience and company knowledge — yell at them once for a mistake, they won't make it twice. Still not good enough? Fire them — the next one will be more obedient.\n\n🛡️ **No more hallucinations** — Tired of AI agents that confidently produce nonsense? We ship with a **[Talent Market](https://carbonkites.com)** — community-verified AI employees that actually deliver. Not random hallucination machines — these ones had to pass an interview.\n\n⚙️ **Not just a company — an operating system** — A unified runtime that abstracts away AI differences, so Claude Code, OpenClaw, and other heavyweights all work for you; skill packages on the Talent Market install like phone apps; swap the direction, swap the team, and you've got a whole new company.\n\n---\n\n## Why OneManCompany?\n\nToday's AI tools help you do individual tasks — write an email, generate an image, fix a bug. Cute. OneManCompany gives you **an entire organization.**\n\n- **Not a chatbot** — a company with org structure, hiring, task management, performance reviews, and knowledge management\n- **Not a demo** — delivers production-grade output (games, comics, apps — not \"here's a draft, good luck\")\n- **Not a framework** — a complete platform you can run from your browser, no code required\n\n### What You Can Build\n\n| AI Company | What It Delivers |\n| -------------------- | ----------------------------------------------------------------- |\n| 🎮 AI Game Studio | Production-grade games with full playtesting and iteration cycles |\n| 📖 AI Manga Studio | Serialized comic stories with consistent art and narrative |\n| 💻 AI Dev Agency | Ship software products end-to-end |\n| 🎨 AI Content Studio | Marketing campaigns, branded content, and media production |\n| 🔬 AI Research Lab | Literature review, data analysis, and report generation |\n\nThese aren't toy demos — each AI company produces **product-level deliverables** through a full team of collaborating AI agents.\n\n### How We're Different\n\n| | Typical Agent Orchestrators | OneManCompany |\n| ------------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Agent architecture** | Flat task runners, BYOA | Vessel + Talent separation — deep modular architecture with 6 Harness protocols and 3-tier customization |\n| **Where do agents come from?** | You find and configure them yourself | **Founding C-suite built-in on Day 1**. Other employees hired by HR from a community-verified **Talent Market** — no more hunting for good agents |\n| **Execution model** | Heartbeat polling / loop | Event-driven, zero-idle, on-demand dispatch |\n| **Organization** | Simple task queues | Full Fortune 500-style company simulation (see below) |\n| **Deliverables** | Single-point task outputs | Production-grade, multi-iteration project delivery with quality gates |\n\n### Why We Deliver Product-Grade Output\n\nScattered AI tools stop at draft-quality output. OneManCompany replicates the full business processes of successful companies, minimizing human intervention for end-to-end delivery:\n\n- **Enterprise-style task orchestration** — The multi-agent system automatically breaks complex projects into specialized phases (requirements → design → development → testing → deployment), assigns owners, and coordinates like a real team.\n- **Smart talent matching** — The recruiting agent matches the right AI employee to every role — senior engineer, UI/UX designer, project manager — ensuring skills align precisely with task demands.\n- **Closed-loop management & organizational evolution** — After delivery, the system automatically runs retrospectives, captures lessons learned, and optimizes workflows. Insights from every project (better coding standards, design feedback, problem-solving strategies) are distilled into employee-level work experience and company-level knowledge base, making the entire organization better with use.\n\n### Built Like a Real Company\n\nWe didn't just borrow corporate vocabulary — we faithfully modeled how Fortune 500 companies actually operate:\n\n- **Org chart & reporting lines** — hierarchical management, department-based structure\n- **Hiring & onboarding** — HR searches Talent Market, CEO interviews, automated onboarding flow\n- **Firing & offboarding** — yes, you can fire underperformers (with proper cleanup, not just `kill -9`)\n- **Performance reviews** — quarterly scoring, probation, PIP, promotion tracks\n- **Task delegation & approval chains** — CEO → executives → employees, with quality gates at every level\n- **Meeting rooms** — multi-agent synchronous discussions with meeting reports\n- **Knowledge base & SOPs** — company culture, direction docs, workflow definitions\n- **File change approvals** — employees propose edits, CEO reviews diffs and approves in batch\n- **Cost accounting** — per-project LLM token usage and USD cost tracking\n- **1-on-1 coaching** — CEO guidance sessions that permanently shape employee behavior\n- **Hot reload & graceful restart** — zero-downtime deployments for AI companies\n\nSomething missing? [Open an issue](https://github.com/1mancompany/OneManCompany/issues) or build it yourself — that's the beauty of open source.\n\n### Why It's an OS, Not Just a Company\n\nA company is a team with specific goals and members. An operating system is the underlying infrastructure that gives your team scalability, flexibility, and the ability to evolve. OneManCompany doesn't build **a** company — it lets you build **any** company. Three traits make it an operating system, not just a product:\n\n1. **Unified Runtime** — An OS abstracts away hardware differences so you don't care if the CPU is Intel or AMD. OneManCompany abstracts away AI differences — you don't need to know if your employee runs on Claude Code or OpenClaw. The Vessel layer handles scheduling, retries, and communication uniformly.\n2. **Install Employees Like Apps** — Phone OS has an app store; OneManCompany has a Talent Market. Need a designer? HR hires one from the market, plug and play. Not performing? Coach them or fire them — the next one will be better.\n3. **Same System, Different Company** — The same iOS can be your work phone or your kid's gaming device — it depends on what apps you install and how you configure it. OneManCompany works the same way: swap the Direction, Culture, and Talents, and you have an entirely different company.\n\n### Open Ecosystem, Unlimited Possibilities\n\nOneManCompany goes beyond built-in capabilities — it's open to the global agent community.\n\n**If you're an AI builder**, your agents can be packaged as AI employees (game developers, comic artists, full-stack engineers) and published to the Talent Market, empowering thousands of users and turning your work into scalable value.\n\n**If you're a CEO user**, you can load powerful agents built by others and make them your employees, bringing stronger delivery capabilities to your company. Each agent's core abilities are packaged as modular Skills (e.g., \"React component development\", \"2D character design\") that can be freely combined for any project.\n\nYou're not just using AI — you're leading a continuously growing, dynamically expanding organization that delivers professional-grade results at a fraction of the cost of a real team.\n\n---\n\n## Features\n\n| | |\n| -------------------------------------------------------------------- | ------------------------------------------------------------- |\n| **Task Tree** — Hierarchical task breakdown with dependency tracking | **Task Management** — CEO reviews and approves at every level |\n\n---\n\n## How It Works\n\nYou open a browser. You see a pixel-art office. Your AI employees are at their desks, pretending to look busy.\n\nYou type: *\"Build a puzzle game for mobile\"*\n\n1. Your **EA** receives the task and routes it\n2. Your **COO** breaks it down and dispatches subtasks\n3. Engineers, designers, and QA **work autonomously**\n4. They hold **meetings** to align when needed\n5. Work goes through **review, iteration, and quality gates**\n6. You get notified and approve the final result\n\n**You manage. AI executes.**\n\n```text\nCEO (You, the only human who gets coffee breaks)\n └── EA ── routes tasks, quality gate\n ├── HR ── hiring, performance reviews, promotions\n ├── COO ── operations, task dispatch, acceptance\n │ ├── Engineer (AI) ← hired from Talent Market\n │ ├── Designer (AI) ← hired from Talent Market\n │ └── QA (AI) ← hired from Talent Market\n └── CSO ── sales, client relations\n```\n\n**Founding team (EA, HR, COO, CSO)** comes built-in. Need more people? HR searches the **Talent Market** — a community-verified marketplace of AI employees.\n\n### The Vessel + Talent System\n\nThink of it like **EVA or Gundam** — a powerful mech that comes alive when a pilot is plugged in.\n\n- **Vessel** (the mech) = execution container. Defines how an employee runs: retry logic, timeouts, tool access, communication protocols.\n- **Talent** (the pilot) = capability package. Brings skills, knowledge, personality, and specialized tools.\n- **Employee** = Vessel + Talent. Hire from the Talent Market, and the system handles the rest.\n\n> For a deep dive into the Vessel architecture, see [docs/vessel-system.md](docs/vessel-system.md).\n\n---\n\n## Quick Start\n\n### Prerequisites\n\nYou only need **Node.js 16+** and **Git**. Everything else (UV, Python 3.12, dependencies) is installed automatically.\n\n### Execution Modes\n\nFounding employees (EA, HR, COO, CSO) support two execution modes, switchable in settings:\n\n| Mode | Description | Requirements |\n| --- | --- | --- |\n| **Company Hosted Agent** | OMC's built-in agent, calls LLMs via OpenRouter | OpenRouter API Key (configured in setup wizard) |\n| **Claude Code** | More capable, lower token cost | Install [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) + [Claude Pro/Max subscription](https://claude.ai) |\n| **OpenClaw** | Open-source alternative, multiple LLM backends | Install [OpenClaw CLI](https://github.com/anthropics/openclaw) + compatible LLM API Key |\n\nDefaults to Company Hosted Agent — no extra subscription needed to get started. Install the corresponding CLI before using Claude Code or OpenClaw, see [Execution Modes docs](https://carbonkite.github.io/OneManCompany/docs/guide/execution-modes/) for details.\n\n