Introduction
HUMΛN is the trust layer between people and AI. It sets the rules for what humans and agents can do, and keeps the receipts. This hub teaches that story as a ladder — then the official 15-minute path.
HUMΛN is a protocol for governed work. Every consequential call — human or agent — composes four answers before it runs:
| Question | Answered by |
|---|---|
| Who is acting? | Passport — portable cryptographic identity |
| What can they actually do? | Capability Graph — evidence-backed capability truth |
| Who allowed it? | Delegations — scoped, expiring, revocable authority |
| What happened? | Provenance — signed, contestable receipts |
HumanOS is the enforcement layer that composes those answers on every call. You define the policies; it enforces them. When a call needs human judgment, Workforce routes it to a qualified person with full context. When a person needs a capability they don't yet have, Academy is how they build it — as verifiable evidence, not certificates.
Why this exists
If you build agents today, you rebuild the same trust stack per project: identity glue, permission checks, audit logging, escalation paths. Each one bespoke, none portable, and each one competing with your actual feature work for time. HUMΛN moves that stack into the protocol so your agent code carries only the logic that is actually yours.
Concretely, the SDK gives you:
- Identity that survives your app. Passports for humans and agents are device-rooted and portable — not rows in your users table.
- Authorization you can reason about. Delegations are scoped grants with expiry and revocation, checked at call time — not
if (user.isAdmin). - Receipts by default. Every governed call lands in the Ledger with signed provenance. You do not write audit logging; you inherit it.
- Escalation as a primitive.
ctx.escalate()routes to a qualified human with context, instead of a TODO comment and a Slack ping.
The ladder
The concept pages read in order. Each layer assumes the one before it:
- Passport — identity for humans and agents
- Capability Graph — what each identity can demonstrably do
- Delegations — authority granted between identities
- HumanOS — enforcement across every call
- Provenance — the record that makes it all inspectable
- Workforce — humans in the execution path
- Academy — growing capability on the same graph
Where to go next
- Build something now — the Quickstart gets you from install to a governed API call in under ten minutes.
- Browse working recipes — the pattern library covers Passport, HumanOS, Workforce, and deployment tasks.
- Work from the terminal — the CLI reference documents every
humancommand. - Full API surface — the API reference lists every endpoint, schema, and example.