Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
company
Project supervisor CLI for the OpenCompany stack. The public command is
company; the npm package is @zeenie-ai/opencompany, and the legacy machina bin
remains as a deprecated compatibility alias. It is also backwards-compatible
with bun run start/dev/stop/etc.
Install
No install step is required for a source checkout: bin/cli.js and the root
package.json scripts both invoke python -m cli from the repo root;
scripts/postinstall.js deliberately does not pip-install it. To install the
company entry point on PATH:
python -m pip install -e . # run from the repository root, not from cli/
Use
company --help # list commands
company stop # kill ports + orphans + temporal
Or via the package.json scripts (bun run <script>, which invoke the same Python CLI):
bun run stop
Cross-platform notes
- Windows:
pythonresolves correctly out of the box. - macOS / Linux: requires
pythonto point to Python 3.12+. Most modern distros provide this viapython-is-python3or a symlink. If your distro only shipspython3, runpython3 -m cli <cmd>or add an alias.
Architecture
Built on battle-tested primitives — minimal custom code:
| Layer | Library |
|---|---|
| CLI | typer |
| Subprocess | anyio.open_process |
| Tree-kill | psutil + pywin32 (Job Objects on Windows) |
| Restart backoff | stdlib (deque + monotonic time + jittered exponential, ~20 LOC) |
| Output | rich.Console |
| Env | stdlib parser over .env.template, .env, and .env.dev |