Home

🐔 Coop Wiki

Coop is an open-source AI agent farm OS in Rust. Run autonomous AI agents — Hens — on a Raspberry Pi, a Mac, a Windows box, or a fleet of cloud nodes. One static binary: no Python, no Docker required.

🚧 Pre-alpha — v0.1 "ALONE FARMER". APIs may change before 1.0.

---

📖 Find your page

🚀 New here? Start in order:

1. Quickstart — install, seal a key, run your first Hen in ~1 minute
2. BYOK Secrets — where the model key comes from (local vault or Azure Key Vault)
3. Network Isolation — restrict what each Hen can reach

⚙️ Running a farm:

Page	What
Deployment	Docker · Compose · systemd · reverse proxy / tunnel
Configuration	Every environment variable, in one table
Discord Connector	One Discord channel per chicken

📚 Reference:

Page	What
Architecture	Crates, layers, and the open-core split
Security Model	Threat model + the full hardening table
FAQ and Troubleshooting	Common errors and their fixes

The wiki is the practical operator's guide. For the source of truth on any detail, the in-repo docs/ and SECURITY.md win.

---

🐔 What is a "Hen"?

A Hen is one autonomous agent:

• a manifest (name, brain, tools, optional network: policy),
• a sealed BYOK model key,
• a confined workdir, and
• a lifecycle: Defined → Hatching → Idle → Working / Sleeping / Leased.

Each Hen runs its bash tool inside its own OS sandbox and can be held to an egress policy, so one chicken can't read another's files or reach forbidden hosts.

---

⚡ One-minute taste

curl -fsSL https://raw.githubusercontent.com/dcluomax/coop/main/scripts/install.sh | sh
export COOP_PASSPHRASE='change-me'
coop vault init ~/.coop/vault.json
COOP_SECRET_VALUE='sk-ant-...' coop vault put ~/.coop/vault.json byok-anthropic
COOP_VAULT=~/.coop/vault.json coopd serve &
coop hen create examples/aria.yaml
coop hen hatch local.coop/aria
coop job run   local.coop/aria "list files in your workdir using bash"

Open http://127.0.0.1:9700/ for the Farm UI. Full walkthrough → Quickstart.

---

📜 License

Code is Apache-2.0, spec docs CC-BY-4.0, assets CC-BY-SA-4.0. The cross-Coop Market layer is a separate proprietary component; the OSS daemon has zero market awareness. See Architecture.