mirror of https://github.com/google/ax.git synced 2026-10-02 03:14:37 +08:00

Files

T

JBD dc4f36cdba Restructure AX into a general-purpose orchestration layer for agentic tasks

AX is undergoing a significant redesign, moving away from a single CLI with
an embedded Python harness toward a general-purpose orchestration layer for
agentic tasks. The repository is reorganized around three binaries: ax-server
exposes a gRPC API for submitting Task manifests, ax-controller runs as a
horizontally scaled reconciler that consumes work from Redis Streams, and
ax-task-runner executes tasks inside sandboxed workers. Task state now lives
in Redis rather than Kubernetes CRDs so the system can handle millions of
short-lived tasks without straining etcd. The legacy Python harness, ATE
client, SQL event log, and skill examples are removed, and new design,
concepts, manifest, networking, runner, and sandbox docs plus Kubernetes
deploy manifests describe the new architecture.

2026-09-19 20:14:43 -07:00

824 B

Raw Blame History

Development

Prerequisites

Go 1.27+
ko for building and deploying control plane images
Docker or Podman for the task runner image
A Kubernetes cluster and kubeconfig

Build

make build                 # bin/ax, bin/ax-controller, bin/ax-server
make install               # install the ax CLI into $(go env GOPATH)/bin
make build-task-runner     # cross-compile the runner for linux/amd64 and build its image
make push-task-runner      # ...and push it (set TASK_RUNNER_REPO)

Test

Runs everything, including the mock Substrate gRPC server, in-memory store validation, and API server tests:

make test        # or: go test -v ./...

Contributing

See CONTRIBUTING.md for contribution guidelines, CLA requirements, and PR workflows.

824 B Raw Blame History