About this project

AX is a high-throughput, declarative orchestrator designed to run billions of autonomous agent workloads in a cluster. It runs on top of Agent Substrate for sandboxed execution and is built to scale to billions of tasks per cluster. If you have used Kubernetes, `ax` will feel similar. Key primitives include: - **Task**: Runs untrusted agent code in an isolated sandbox with CPU/memory limits. - **Workspace**: Pre-wires Git repos, MCP servers, and skill packages so every agent starts warm. - **Gateway**: Locks outbound traffic down to an explicit host allowlist. - **Model**: Configures which LLM the platform itself uses, with credentials from a Kubernetes secret. Everything is expressed as `ax.io/v1alpha1` manifests and applied with a single command. The CLI is `kubectl`-shaped, supporting `apply`, `get`, `describe`, `watch`, `delete`, plus agent-specific verbs like `ax ssh`, `ax suspend`, and `ax resume`. Quick start involves installing the CLI via `go install`, deploying the control plane to a Kubernetes cluster using `make deploy`, and then applying example manifests. The project includes extensive documentation covering concepts, manifests, sandbox behavior, runner contracts, networking, architecture, development, and roadmap. AX is licensed under Apache License 2.0.