mirror of
https://github.com/google/ax.git
synced 2026-10-20 05:39:15 +08:00
JBD
dc4f36cdba
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.
30 lines
824 B
Markdown
30 lines
824 B
Markdown
# Development
|
|
|
|
## Prerequisites
|
|
|
|
- Go 1.27+
|
|
- [`ko`](https://ko.build/) for building and deploying control plane images
|
|
- Docker or Podman for the task runner image
|
|
- A Kubernetes cluster and kubeconfig
|
|
|
|
## Build
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
make test # or: go test -v ./...
|
|
```
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](../CONTRIBUTING.md) for contribution guidelines, CLA requirements, and PR workflows.
|