Skip to content

README.md

Latest commit

 

History

History
109 lines (75 loc) · 12.7 KB

README.md

File metadata and controls

109 lines (75 loc) · 12.7 KB
Raw

AI Agent Assembly

Core CI License: Apache 2.0 Core release Discussions

AI Agent Assembly is an open-source governance platform for AI agents. It enforces policy, tracks budget, and audits every action your agents take across three independent interception layers — in-process SDKs, a sidecar proxy, and eBPF kernel hooks — so you can ship multi-agent fleets without losing control of what they do.

Developer Start Here

Repository Status

Repo Purpose Version Base branch health Activity
agent-assembly Core Rust monorepo: gateway, policy engine, CLI, API, dashboard GitHub tag crates.io CI issues PRs last commit
python-sdk Python SDK (PyO3 native + pure-Python client) GitHub release PyPI CI issues PRs last commit
node-sdk TypeScript SDK (napi-rs native + JS client) GitHub release npm Tests issues PRs last commit
go-sdk Go SDK GitHub tag Go Reference Go test issues PRs last commit
.github Organization profile, templates, support, and community files — last commit issues PRs
homebrew-agent-assembly Homebrew tap for aasm formula Homebrew last commit issues PRs
agent-assembly-docs Public documentation site tracks Deploy issues PRs last commit
agent-assembly-spec Shared specifications and protocol contracts reserved last commit issues PRs
agent-assembly-examples Runnable sample code for every SDK plus policy, approval, audit, trace, and runtime workflows last commit issues PRs

Sample code starts here: agent-assembly-examples is the canonical entrypoint for learning by running small, framework-specific examples for Python, Node.js/TypeScript, Go, policy enforcement, approvals, audit, trace, and runtime workflows.

Install channels

Homebrew (macOS, Linux)

brew install ai-agent-assembly/homebrew-agent-assembly/aasm

Python — pip, uv, or poetry

# pip
pip install agent-assembly

# uv
uv add agent-assembly

# poetry
poetry add agent-assembly

Node.js — pnpm (recommended), npm, or yarn

# pnpm (recommended)
pnpm add @agent-assembly/sdk

# npm
npm install @agent-assembly/sdk

# yarn
yarn add @agent-assembly/sdk

Go — go get

go get github.com/ai-agent-assembly/go-sdk

Docker

A published container image is coming soon. No image is available on ghcr.io yet.

curl one-line installer (CLI)

curl -sSf https://raw.githubusercontent.com/ai-agent-assembly/agent-assembly/master/scripts/install-cli.sh | sh

A short hosted alias (https://install.ai-agent-assembly.dev) is planned but not yet live — use the raw.githubusercontent.com URL above for now.

Release and Homebrew Notes

  • agent-assembly is on a pre-stable beta channel — see the Core release badge above for the current version.
  • The Homebrew tap's Formula/aasm.rb now ships real, published sha256 checksums for the released aasm artifacts — the earlier zero-checksum bootstrap state is obsolete.

Full Production Highlights

Core differentiation

  1. Lowest-intrusion integration: one-line init across major agent frameworks.
  2. Three-layer interception: semantic to protocol to kernel, with selectable depth.
  3. Secret Injection: real credentials never appear in LLM context windows.
  4. Tool Execution Sandbox: isolated execution to reduce security risk.
  5. Human-in-the-loop Gate: high-risk actions require human review.

Enterprise governance

  1. Agent Identity and Zero-trust A2A
  2. Cost and Token Budget Governance
  3. Org / Team / Agent hierarchy management
  4. Audit Trail and Compliance Export

Deployment flexibility

  1. Local Dev Mode (zero-config, OSS)
  2. SaaS Cloud (managed enterprise control plane)

Prioritize these three above the fold: lowest-intrusion integration, Secret Injection, and Human-in-the-loop Gate.