Quickstart

Quickstart

Get a Hen reasoning in about a minute.

1. Install

curl -fsSL https://raw.githubusercontent.com/dcluomax/coop/main/scripts/install.sh | sh

This drops coopd (daemon) and coop (CLI) into /usr/local/bin (or ~/.local/bin). Prefer building from source? git clone … && cargo build --release (Rust 1.85+); binaries land in target/release/.

2. Seal your model key in a BYOK vault

export COOP_PASSPHRASE='change-me'
coop vault init ~/.coop/vault.json
COOP_SECRET_VALUE='sk-ant-...' coop vault put ~/.coop/vault.json byok-anthropic

The vault is an xchacha20poly1305 sealed file (mode 0600); the passphrase never touches disk. Prefer to keep keys in Azure Key Vault instead? See BYOK Secrets.

3. Start the daemon (auto-unlocking the vault)

COOP_VAULT=~/.coop/vault.json coopd serve &

4. Define + run a Hen

A starter manifest lives at examples/aria.yaml:

spec_version: coop/v1
name: aria
brain:
  provider_id: vault:byok-anthropic
  model: claude-sonnet-4-5-20250929
tools: [bash, file_read, file_write, http]

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"
coop job wait   <job-id>

Open http://127.0.0.1:9700/ to watch your hens in the Farm UI — click any hen to drop into a live PTY shell in its workdir.

Next

• Run it 24/7 or on another machine → Deployment
• Every environment variable → Configuration
• Restrict what a hen can reach → Network Isolation
• Bridge it to Discord → Discord Connector