OneManCompany

The Agent Operating System for One Man Companies

Homepage  ·  中文文档  ·  Docs  ·  Talent Market  ·  Issues

Others use AI to write code. You use AI to run a company.

Linux runs servers. OneManCompany runs companies.

Not building a company — building any company.

OneManCompany is an open-source OS that lets anyone build and run a complete AI-powered company from their browser. It doesn't replace tools like Claude Code, Codex, or other agent frameworks — it operates one level above them as an agentic operating system, orchestrating hierarchical AI teams built on top of these underlying tools.

You are the CEO — the only human. Everyone else — HR, COO, engineers, designers — are AI employees that think, collaborate, and deliver real work autonomously. (No slacking, no sick days, no raise requests — just the occasional need for a pep talk.)

⚙️ An OS, not just a product: Swap the plan, swap the clan — brand new company in your hand. One runtime abstracts away AI differences. Skills install like phone apps. Same system, different direction and team — entirely new company.

🤖 Real agents, but top talent welcome: Built-in execution engine, task scheduling, retry & fault tolerance, multi-agent communication protocols. OpenClaw, Claude Code, and other powerful agents can move right in as employees. Yes, there's a visualization — but that's just the surface. Underneath runs a full operating system. The pixel-art office is just the tip of the iceberg.

🏢 Real company, not a chatbot: Interview, review, promote the few — fire the ones who haven't got a clue. Yes, your AI employees get nervous. Org chart, hiring pipelines, performance reviews, approval chains, meeting rooms — modeled after Fortune 500 management.

🤝 Agents that actually collaborate: Your team talks to each other — not just to you. Engineers pull in designers, COO coordinates the big picture, employees call their own meetings to align — multi-agent meetings, cross-functional delegation, structured handoffs. Real teamwork, not parallel chat windows pretending to be a company.

🛡️ No more hallucination roulette: Download counts and real reviews don't lie — trust the community. Tired of AI that talks big and delivers nothing? We ship with a Talent Market of battle-tested, community-scored AI employees. No self-proclaimed "I'm an expert in everything" agents allowed.

📈 Gets smarter with use: Your team forgets nothing — even the AI employees it forgets. Every retrospective and 1-on-1 becomes lasting experience. Tell them once, they learn. Tell them twice, they remember. Still no good? Replace them — the next one already heard what happened to the last one.

npx @1mancompany/onemancompany

One command. A full AI company in your browser. No Python, no Docker, no config — just run it.

If this project is useful to you, please consider giving it a ⭐ — it helps others discover OneManCompany.

Features

Hierarchical task breakdown — CEO delegates, AI employees execute.

Talent Market — find, hire, and onboard community-verified AI employees.

Demos

"Make me a game" CEO gives one sentence — the team builds a complete game autonomously.

More demos coming soon — request one

Watch all demos with full video on our website →

How It Works

You open a browser. You see a pixel-art office. Your AI employees are at their desks, pretending to look busy.

You type: "Build a puzzle game for mobile"

1. Your EA receives the task and routes it
2. Your COO breaks it down and dispatches subtasks
3. Engineers, designers, and QA work autonomously
4. They hold meetings to align when needed
5. Work goes through review, iteration, and quality gates
6. You get notified and approve the final result

You manage. AI executes.

CEO (You, the only human who gets coffee breaks)
  └── EA ── routes tasks, quality gate
        ├── HR ── hiring, performance reviews, promotions
        ├── COO ── operations, task dispatch, acceptance
        │    ├── Engineer (AI)  ← hired from Talent Market
        │    ├── Designer (AI)  ← hired from Talent Market
        │    └── QA (AI)        ← hired from Talent Market
        └── CSO ── sales, client relations

Founding team (EA, HR, COO, CSO) comes built-in. Need more people? HR searches the Talent Market — a community-verified marketplace of AI employees.

What You Can Build

These aren't toy demos — each AI company produces product-level deliverables through a full team of collaborating AI agents.

How We're Different

Quick Start

You only need Node.js 18+ and Git. Everything else is installed automatically.

npx @1mancompany/onemancompany

# Install Git (if not already installed)
xcode-select --install

# Launch (auto-installs UV + Python 3.12 + dependencies)
npx @1mancompany/onemancompany

# Install Git: https://git-scm.com/download/win
# Install Node.js: https://nodejs.org/

# Launch (auto-installs UV + Python 3.12 + dependencies)
npx @1mancompany/onemancompany

# Install prerequisites
sudo apt update && sudo apt install -y git nodejs npm

# Launch (auto-installs UV + Python 3.12 + dependencies)
npx @1mancompany/onemancompany

First run automatically:

1. Installs UV (fast Python package manager)
2. Installs Python 3.12 via UV (isolated, no system changes)
3. Clones the repository
4. Creates venv and installs dependencies
5. Launches the setup process

Then open http://localhost:8000. Congratulations, you're a CEO now.

Execution Modes

Founding employees (EA, HR, COO, CSO) support three execution modes, switchable in settings:

Defaults to Company Hosted Agent — no extra subscription needed to get started. See Execution Modes docs for details.

Manage Your Service

# Restart / auto-update
npx @1mancompany/onemancompany

# Debug mode (foreground with logs, Ctrl+C to stop)
npx @1mancompany/onemancompany --debug

# Stop background service
npx @1mancompany/onemancompany stop

# Re-run setup process
npx @1mancompany/onemancompany init

# Custom port
npx @1mancompany/onemancompany --port 8080

# Uninstall (stops service + deletes all generated files)
# This will remove everything. To preserve your business data,
# back up .onemancompany/company/business/ before uninstalling.
npx --yes @1mancompany/onemancompany@latest uninstall

Manual Install (Dev Mode)

# 1. Clone
git clone https://github.com/1mancompany/OneManCompany.git
cd OneManCompany

# 2. Start (auto-installs UV + Python if needed)
bash start.sh

# 3. Open browser
open http://localhost:8000

Configuration Files

Using Azure AI Foundry / Azure OpenAI? See docs/providers-azure.md.

Under the Hood

Why It's an OS, Not Just a Company

A company is a team with specific goals. An operating system is the infrastructure that gives your team scalability, flexibility, and the ability to evolve. Three traits make OneManCompany an OS:

1. Unified Runtime — 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.
2. Install Employees Like Apps — Phone OS has an app store; we have a Talent Market. Need a designer? HR hires one, plug and play. Not performing? Fire them — the next one will be better.
3. Same System, Different Company — Swap the Direction, Culture, and Talents, and you have an entirely different company. A game studio today, a dev agency tomorrow.

Built Like a Real Company

We faithfully modeled how Fortune 500 companies actually operate:

• Org chart & reporting lines — hierarchical management, department-based structure
• Hiring & onboarding — HR searches Talent Market, CEO interviews, automated onboarding flow
• Firing & offboarding — yes, you can fire underperformers (with proper cleanup, not just kill -9)
• Performance reviews — quarterly scoring, probation, PIP, promotion tracks
• Task delegation & approval chains — CEO → executives → employees, with quality gates at every level
• Meeting rooms — multi-agent synchronous discussions with meeting reports
• Knowledge base & SOPs — company culture, direction docs, workflow definitions
• File change approvals — employees propose edits, CEO reviews diffs and approves in batch
• Cost accounting — per-project LLM token usage and USD cost tracking
• 1-on-1 coaching — CEO guidance sessions that permanently shape employee behavior
• Hot reload & graceful restart — zero-downtime deployments for AI companies

Something missing? Open an issue or build it yourself — that's the beauty of open source.

Why We Deliver Product-Grade Output

Scattered AI tools stop at draft-quality output. OneManCompany replicates full business processes to minimize human intervention:

• Enterprise-style task orchestration — Automatically breaks complex projects into specialized phases (requirements → design → development → testing → deployment), assigns owners, and coordinates like a real team.
• Smart talent matching — The recruiting agent matches the right AI employee to every role, ensuring skills align precisely with task demands.
• Closed-loop evolution — After delivery, the system runs retrospectives, captures lessons learned, and optimizes workflows. Every project makes the entire organization better.

The Vessel + Talent System

Think of it like EVA or Gundam — a powerful mech that comes alive when a pilot is plugged in.

• Vessel (the mech) = execution container. Defines how an employee runs: retry logic, timeouts, tool access, communication protocols.
• Talent (the pilot) = capability package. Brings skills, knowledge, personality, and specialized tools.
• Employee = Vessel + Talent. Hire from the Talent Market, and the system handles the rest.

For a deep dive into the Vessel architecture, see docs/vessel-system.md.

Open Ecosystem

OneManCompany goes beyond built-in capabilities — it's open to the global agent community.

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.

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.

You'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.

Vision & Roadmap

Near-term: Enable 100 AI one man companies within one year.

Long-term: Redefine the relationship between AI, humans, and organizations.

TODO

• More built-in tools (Kanban board, progress visualization, Gantt chart, etc.)
• Selectable frontend themes (futuristic, cyberpunk, minimalist, pixel-art, etc.)
• More LLM provider options (Ollama local, Azure OpenAI, AWS Bedrock, etc.)
• More efficient AI collaboration (multi-agent handoff, parallel execution, conflict resolution)
• More efficient company-hosted agent Vessel logic (smarter retry, context carryover, cost-aware scheduling)

Contributions welcome — we encourage vibe-coding. AI contributors please follow the vibe-coding-guide.

This is a living plan — request a feature or contribute directly.

Documentation

Full Documentation Site — Feature guides, usage instructions, and technical reference.

Community & Contributing

• Build Talents — Create new AI employee types for the Talent Market
• Build Tools — Add integrations (APIs, services, platforms)
• Add Company Features — Performance dashboards, OKR tracking, employee training...
• Improve the OS — Core engine, frontend, documentation
• Share Demos — Show what your AI company can build
• Report Issues — Help us find and fix bugs

_{Scan to open the permanent OMC WeChat community entry}

See vibe-coding-guide.md for coding guidelines.

Star History

Citation

If you use OneManCompany in your research or project, please cite it:

@software{onemancompany2026,
  title = {OneManCompany: The Agent Operating System for One-Person Companies},
  author = {Zhengxu Yu, Fu Yu, Zhiyuan He, Yuxuan Huang, Lee Ka Yiu, Meng Fang, Weilin Luo, Jun Wang},
  email = {yuzxfred@gmail.com},
  url = {https://github.com/1mancompany/OneManCompany},
  year = {2026},
  license = {Apache-2.0}
}

Links

Talent Market — Community-verified AI employee marketplace (Built an amazing AI agent but no one uses it? List it on the market — let it work for someone's company!)

Talent Template — Template repo for building your own Talents

License

Apache License 2.0 — Free for commercial use and modification, with attribution required.