Repository navigation
v0.4.0-rc.1
Pre-release
Pre-release
Install
Requires Agent Substrate v1.0.0; see docs/installation.md.
kubectl create namespace ax-system --dry-run=client -o yaml | kubectl apply -f -
kubectl -n ax-system create secret generic ax-postgres --from-literal=password="$(openssl rand -hex 24)"
kubectl apply -f https://github.com/google/ax/releases/download/v0.4.0-rc.1/postgres.yaml
kubectl apply -f https://github.com/google/ax/releases/download/v0.4.0-rc.1/ax-server.yamlThe ax CLI is attached for linux and darwin (amd64, arm64).
curl -fsSL https://github.com/google/ax/releases/download/v0.4.0-rc.1/install.sh | AX_VERSION=v0.4.0-rc.1 shor download ax_<os>_<arch>.tar.gz and check it against checksums.txt.
| Image | Reference |
|---|---|
| ax-server | ghcr.io/google/ax/ax-server@sha256:95737151ccc54fdb8d99a8a8674f11777d7b08b7108a7b80820a1c502bb71223 |
| ax-task-runner (default task image) | ghcr.io/google/ax/ax-task-runner@sha256:3a61e70d70cede25cec04c34b2902e2febac08bd78741207101d5c102f6e7a2c |
| ax-runner-volume (mounted into every task by this release's ax-server.yaml) | ghcr.io/google/ax/ax-runner-volume@sha256:ac849f8357ac5b412d2d35d9076ef94b00557399d95c52c62353954e2101be07 |
What's Changed
- feat(server): reject resource names that are not RFC 1123 labels by @mvanhorn in #406
- fix(cli): skip empty YAML documents during apply by @ktsoator in #409
- fix(controller): skip reconcile for tasks that are being deleted by @moezdil in #417
- Replace UpdateTask with CreateTask and enforce immutability by @rakyll in #398
- fix(substrate): revert crashed actors instead of recreating them by @AlexsJones in #432
- Clarify Model resource concept description by @rakyll in #401
- fix(substrate): adapt to Substrate v0.4 API and harden actor RPCs by @siyuanfoundation in #457
- Propagate SuspendActor error up from substrate by @YoyinZyc in #464
- docs: describe review, assignment and merge conventions by @mayawang in #469
- docs: add SECURITY.md with reporting process and current trust boundary by @mayawang in #480
- Name the mascot by @rakyll in #481
- feat(runner): serve metadata endpoints on loopback only by @MushuEE in #479
- fix(cli): honour ax ssh --help and stop global flag parsing at -- by @anzal1 in #411
- controller,substrate: handle transient Substrate unavailability without permanent Task failure by @aprajitaarora13 in #463
- feat(cli): forward stdin and Ctrl-C in ax ssh by @anzal1 in #413
- Clean up v1alpha1 field names and drop unused fields by @rakyll in #485
- lock,cli: renew Redis lock leases and lengthen suspend/resume timeout by @siyuanfoundation in #490
- docs: replace the axolotl logo with axel.svg by @rakyll in #497
- fix(cli): honor the atespace flag when applying resources by @ktsoator in #415
- feat(controller): apply Task resource limits to the ActorTemplate by @mvanhorn in #405
- api,runner: bind at most one workspace per task by @rakyll in #496
- chore(substrate): bump github.com/agent-substrate/substrate to v0.5.0 by @siyuanfoundation in #484
- fix(controller): fail task when ActorTemplate creation fails by @itssimrank in #472
- test: add Kind-based E2E test suite and CI workflow by @siyuanfoundation in #474
- runner: ignore unknown fields in specs from the control plane by @MushuEE in #506
- server, store: move to Postgres and read actor state from Substrate by @rakyll in #515
- api,runner: remove the WorkspaceRef goal field and the agent bootstrap by @rakyll in #519
- api,cli: remove WatchTask and ax watch by @rakyll in #522
- Add an optional google.protobuf.Struct config field to TaskSpec by @rakyll in #523
- README: use a realistic agent task in the intro example by @rakyll in #524
- README: describe AX as running millions of tasks per cluster by @rakyll in #525
- README: drop command from example Task by @rakyll in #527
- chore(substrate): bump substrate to v0.6.0 and update control/dataplane integration by @siyuanfoundation in #517
- build: replace ko with
make imagesusing podman or docker by @rakyll in #508 - make: deploy the task image by the digest make images recorded by @mayawang in #529
- test/e2e: cache pre-built Substrate images between CI runs by @rakyll in #521
- store/postgres: test that a restart keeps tasks and releases locks by @mayawang in #528
- docs: document default task CPU and memory limits (1000m, 512Mi) by @siyuanfoundation in #530
- server: remove the Reconciler interface by @yongruilin in #532
- demo.sh: use spec.workspace and the server's default task image by @yongruilin in #533
- chore: add AGENTS.md contract and skills by @YoyinZyc in #535
- docs: add a version-pinned installation guide and clarify prerequisites by @mayawang in #500
- Add Claude Code example by @rakyll in #513
- controller: replace Reconcile with explicit Suspend and Resume by @yongruilin in #536
- fix(ssh): honor --namespace in ax ssh and surface router mTLS errors by @YoyinZyc in #544
- chore(substrate): bump substrate to v1.0.0-rc.1 and adapt to Substrate 1.0 changes by @siyuanfoundation in #553
- Reject a Task whose bound Workspace does not exist by @erain in #461
- tunnel: respect the client certificate's expiry in the router TLS cache by @rakyll in #541
- docs: fix the quick start (WorkerPool, resume after apply) and examples by @mayawang in #505
- workspace: keep the maiden-run marker on the workspace volume (#518) by @mayawang in #551
- chore(substrate): bump to v1.0.0 and install it from release images images E2E by @rakyll in #561
- api: split ax.proto into per-resource files by @yongruilin in #564
- api: generate and verify protos with buf by @yongruilin in #565
- ax-server: set up OpenTelemetry tracing, metrics, events, and JSON logs by @erain in #557
- refactor: extract apivalidation, resources, and server workspace handlers by @YoyinZyc in #566
- api: add the Gateway API and manifest validation by @yongruilin in #567
- server, cli: add Gateway CRUD and ax commands by @yongruilin in #569
- ci: add make verify with golangci-lint by @yongruilin in #576
- cli: add --trace to trace a command by @JeffLuoo in #562
- ci: manage repository rulesets as code and combine the main rulesets by @MushuEE in #572
- ci: skip E2E when only docs or repo settings change by @MushuEE in #578
- workspace: align v1alpha1 schema, enforce immutability, and materialize spec.setup by @YoyinZyc in #580
- Add NetworkPolicies for ax-server and Postgres by @yongruilin in #582
- runner: trust the egress CA bundle and give git placeholder credentials by @yongruilin in #581
- server: trace and measure AX RPCs and Substrate calls by @JeffLuoo in #579
- gateway: enforce a task's bound Gateway rules by @yongruilin in #585
- profile, substrate: add Profile template resolution and snapshot Tag client support by @YoyinZyc in #586
- gateway: add Kind E2E for egress rules and credential injection by @yongruilin in #588
- Expose live Substrate actor UIDs in task status and describe output by @erain in #556
- hack: add the v0.1 hero demo harness by @mayawang in #590
- task: update v1alpha1 Task and ObjectMeta schema and update codebase by @siyuanfoundation in #587
- workspace: reserve field 2 in WorkspaceRef for atespace by @YoyinZyc in #599
- task: rename Goal.spec to Goal.text by @rakyll in #604
- api: clean up v1alpha1 proto field numbers and Task status types by @siyuanfoundation in #605
- workspace: add WorkspaceManager snapshot pre-warming and status lifecycle by @YoyinZyc in #592
- Otel v1.47 bump by @JeffLuoo in #606
- hack: drop the workspace profile from the hero demo until pre-warming is on by @mayawang in #607
- feat(cli): add ax local, ax install/uninstall, and one-line installer by @YoyinZyc in #603
- hack: bind a Gateway to the hero demo's Antigravity starter task by @yongruilin in #608
- lock, workspace: add shared RLock to Locker and guard EnsureSnapshotTag against DeleteWorkspace by @YoyinZyc in #617
- ax: add promote to copy a task to another cluster by @yongruilin in #618
- build: add the runner volume image by @aprajitaarora13 in #619
- controller, substrate: mount the runner from a read-only image volume by @aprajitaarora13 in #620
- runner: hand the task to the image's launcher as files by @aprajitaarora13 in #621
- test/e2e: run a pure image with a launcher on the mounted runner by @aprajitaarora13 in #622
- ci: build and publish a release when a vX.Y.Z tag is pushed by @MushuEE in #616
- store: add TaskRow, TaskApplier, and StoredStatus runner seam by @siyuanfoundation in #591
- ax: add Kind E2E for promote by @yongruilin in #629
- fix(tunnel): keep a tunnel per namespace of a context by @yongruilin in #628
- feat(cli): add ax studio launcher and install.sh studio download by @YoyinZyc in #627
- store: implement TaskApplier in memory and postgres backends by @siyuanfoundation in #630
- feat(install): pass the runner volume image through ax local start and ax install by @YoyinZyc in #634
- Runner proto lifecycle by @itssimrank in #633
- hack: promote the hero demo's starter task with ax promote by @yongruilin in #636
- deploy, e2e: expose ax-server-runner :8081 only to atenet-egress in NetworkPolicy by @siyuanfoundation in #631
- runnerhttp, server: add :8081 runner HTTP handler, Actor JWT auth, an… by @itssimrank in #635
- examples: bind a Gateway to the Claude Code example by @yongruilin in #638
- runner, substrate, e2e: address review follow-ups from #620–#622 by @aprajitaarora13 in #624
- task: change TaskStatus.ate_actor_template to ObjectRef ate_template by @siyuanfoundation in #642
- Runner pull agent by @itssimrank in #637
- runner: use MkdirTemp for non-root RunDir fallback by @aprajitaarora13 in #644
- release: publish ax-runner-volume, with a switch to mount it by default by @MushuEE in #626
- feat(axclient): add a public client package for reaching ax-server by @YoyinZyc in #640
- api: return Empty from Delete RPCs, and NotFound for a missing resource by @yongruilin in #645
- README: shorten quick start around install.sh and ax local/install by @rakyll in #646
- hack/hero-demo: wire Step 3 to the starter launcher contract by @aprajitaarora13 in #643
- Server lifecycle suspend resume by @itssimrank in #639
- Fix/friction log local install by @YoyinZyc in #655
- hack/hero-demo: allow storage.googleapis.com and opt into runtime agy install by @Lukeluds in #654
- api: paginate list RPCs with page tokens by @yongruilin in #656
- ax-server, e2e: enable workspace pre-warming by default and add shared custom-image E2E by @itssimrank in #651
- README: require Kubernetes 1.37+ for existing clusters by @MushuEE in #658
- fix(server): ignore client-supplied uid, timestamps and status by @yongruilin in #659
- examples: use the published ateworker-gvisor v1.0.0 image in workerpool.yaml by @MushuEE in #660
- hack/hero-demo: pin Antigravity starter image to v0.0.0-rc.2 by @Lukeluds in #662
- hack/hero-demo: check the warm workspace snapshot in Step 2 by @YoyinZyc in #663
- fix(promote): handle a finished task and a workspace's setup gateway by @yongruilin in #664
- fix(controller): let a task recreated under the same name start by @yongruilin in #667
- docs: add AX Studio to the README and the local installer guide by @YoyinZyc in #668
- hack/hero-demo: follow tasks to completion in Steps 3, 4 and 5 by @yongruilin in #671
New Contributors
- @mvanhorn made their first contribution in #406
- @moezdil made their first contribution in #417
- @siyuanfoundation made their first contribution in #457
- @YoyinZyc made their first contribution in #464
- @mayawang made their first contribution in #469
- @anzal1 made their first contribution in #411
- @aprajitaarora13 made their first contribution in #463
- @itssimrank made their first contribution in #472
- @yongruilin made their first contribution in #532
- @erain made their first contribution in #461
- @JeffLuoo made their first contribution in #562
- @Lukeluds made their first contribution in #654
Full Changelog: v0.3.1...v0.4.0-rc.1