OpenCompany

Run an entire company with a headcount of one.

OpenCompany is the operating layer for one-person businesses powered by agents. You bring the vision and the judgment calls. Your agents do the work: every function, around the clock, at the speed of software.

[!WARNING]
🚧 Work in progress. OpenCompany is under active development and moving
fast. APIs, the CLI, the example harnesses, and the docs will change without
notice. Explore it, fork it, build on it, but don't depend on anything
staying put yet. Not production-ready.

The company of one

For a century, ambition meant headcount. Want to ship a product? Hire engineers.
Want customers? Hire marketers, then sales, then support. Every new capability
was a new payroll line, a new manager, a new quarter of ramp-up.

That tax is gone. OpenCompany turns a single operator into a full org chart.
Scouts, founders, engineers, designers, marketers, lawyers, finance, support and
recruiters, all instantiated as agents, coordinated by one host, working while
you sleep. You stay where humans are irreplaceable: capital, taste, and the
decisions that actually matter. Everything else is delegated.

This isn't a chatbot with a to-do list. It's a company runtime: a durable
host that stands up a roster of specialized agents, gives each one a clear
mandate, and runs them as a coordinated business on top of the OpenHuman and
TinyHumans runtimes.

What one person can now run

Every folder under companies/ is a complete company you can
launch today, with a roster of agents, their responsibilities, and the handful
of moments where a human signs off:

Twenty-two companies. One operator. Pick one and run it, or run several at once.
companies/README.md has the full catalog.

Quickstart

You do not need a software background to run a company. You need
Docker Desktop, a terminal,
and about fifteen minutes. On Windows the terminal must be POSIX —
WSL or Git Bash — because the
quickstart below uses export and ./scripts/launch-demo.sh.

git clone --recurse-submodules https://github.com/tinyhumansai/opencompany.git
cd opencompany
export TINYHUMANS_API_KEY="th-..."          # grab yours at tinyhumans.ai
export OPENCOMPANY_FEATURES="medulla"       # compile in the hosted Medulla brain the key unlocks
./scripts/launch-demo.sh marketing up

The first run takes a few minutes while it downloads and builds. When it
settles, open http://localhost:5173. That's the console, where you watch
your agents work and answer anything waiting on you.
./scripts/list-demos.sh lists the other businesses you can launch in place of
marketing, and ./scripts/launch-demo.sh marketing down shuts it all down.

Prefer to build the host from source, deploy it somewhere, or change the runtime
itself? That path lives in docs/running-locally.md:
Cargo builds, Compose, feature flags, the Tauri desktop preview, and
DigitalOcean / AWS deploys.

You'll want a TinyHumans API key. It's what unlocks Medulla and lets the
agents think and act. Without one you can still launch a company and look
around; the agents just won't do real work. Grab a key at
tinyhumans.ai and
export TINYHUMANS_API_KEY="th-...".

Why it works

• A real org chart, not a prompt. Each company is declared as a roster of
  agents with distinct mandates in a simple company.toml. The host
  instantiates them, coordinates them, and keeps them running.
• Humans in the loop where it counts. Every harness names the exact
  decisions reserved for you. Delegate the work; keep the judgment.
• Built on proven runtimes. OpenCompany is a light host over OpenHuman and
  the TinyHumans agent modules, so it reuses their runtime instead of
  reinventing it.
• Rust-fast and inspectable. An Axum HTTP surface, a small default build,
  and deeper capabilities behind feature flags. Simple to start, honest to
  operate, easy to test.
• Yours to own. GPL-3.0, self-hostable, no lock-in.

The engine: Medulla

A company of one only works if something can hold the whole company in its head.
That something is Medulla, TinyHumans' orchestrator model, purpose-built to
run large fleets of agents as a single coordinated business.

Medulla is orchestrator-first. Every event, whether a customer email, a market
signal or a finished task, lands on a deep orchestration tier that reads the full
picture, decides what matters, and fans the work out across your agents. As your
company grows from nine agents to nine hundred, Medulla is what keeps it
coherent, on-strategy, and moving without you in every message. It's a hosted
model: you reach it with a TinyHumans API key, and OpenCompany is the open host
that points your companies at it.

Make it yours

Each company folder holds a company.toml, a plain text file naming the roles,
what each one owns, and where you want to be asked before anything happens. It's
written to be read by people; changing a role is editing a few lines rather than
programming. opencompany check reports any problems in plain language, and
adding a new business is a new folder, not a new program.
Your first company walks through it.

Documentation

Contributing

New here? Start with the
good first issues,
which are scoped to be finishable in a sitting.
CONTRIBUTING.md has the local checks to run before opening a
pull request, and anything big enough to break an existing company starts as an
RFC
rather than a PR.

Community

Discussions is where
questions get answered and large changes get argued out before they're built.
SUPPORT.md says which channel takes what.

• Discord: https://discord.tinyhumans.ai
• X: @tinyhumansai
• Reddit: r/tinyhumansai
• Website: tinyhumans.ai/opencompany

License

OpenCompany is licensed under the GNU General Public License v3. See
LICENSE.