agent-assembly
agent-assembly is the open-source core of the AI Agent Assembly governance platform. It enforces policy on AI agents — what they may call, spend, and connect to — and records every decision in an immutable audit trail.
This book is the contributor and operator reference for the core. If you build with a language SDK instead, read the per-SDK guides below.
New here? Start with the Introduction — it explains what Agent Assembly is, the problem it solves, the core concepts, and the three-layer interception model. Then move on to the Quick Start.
Other docs: Docs Hub · Python SDK · Node SDK · Go SDK
Run it locally
Point the gateway at a bundled reference policy and you have a governing daemon listening on 127.0.0.1:50051:
git clone https://github.com/ai-agent-assembly/agent-assembly.git
cd agent-assembly
cargo run -p aa-gateway -- --policy policy-examples/low-risk.yaml
From there, attach an SDK shim, the aa-proxy sidecar, or the eBPF layer to start intercepting agent actions. The Architecture chapter explains how those three layers fit together.
Where to go next
| You want to… | Read |
|---|---|
| Understand what this is and why | Introduction |
| Get a gateway running quickly | Quick Start |
Look up an aasm command | CLI Reference |
| Follow a task end-to-end | Usage Guide |
| Understand the threat model and defenses | Security Model |
| See how the crates fit together | Architecture |
| Check which SDK versions are compatible | Compatibility matrix |
| Read the wire-protocol contract | Protocol changelog |
| See latency and build-time numbers | Benchmarks — baseline |
Audience
This book targets contributors and operators of agent-assembly. SDK users (Python, TypeScript, Go) should refer to the per-SDK guides in the sibling repositories.
See also
- README — top-level project overview, prerequisites, quickstart
- CONTRIBUTING — development workflow, branch naming, PR rules
- API reference — generate locally with
cargo doc --workspace --no-deps --open
Diagram rendering
This book renders Mermaid diagrams via the mdbook-mermaid preprocessor:
graph LR
SDK[SDK shim] --> Gateway[aa-gateway]
Proxy[aa-proxy] --> Gateway
eBPF[aa-ebpf] --> Gateway
Gateway --> Audit[(Audit log)]