Prerequisites¶

Everything you need before building or running the AutonomyOps ADK.

Go¶

The ADK is a multi-module Go workspace. Each module’s go.mod specifies its minimum Go version; the workspace go.work ties them together.

Requirement	Version
Go toolchain	1.25 or later
Go modules	Enabled (default since Go 1.16)

Install Go: go.dev/dl

Verify:

go version

Expected: go version go1.25.x linux/amd64 (or later).

!!! info “Workspace baseline” This repo is a multi-module workspace. Use go.work at the repository root as the source of truth for the effective minimum Go toolchain used by CI and release automation.

Make¶

All build, test, lint, and CI targets are driven by GNU Make.

make --version

GNU Make 4.x or later is required.

Docker¶

Required for:

Integration tests that use a container registry (//go:build integration)
The local demo stack (make demo-up and related targets)
FI shell tests that require loop devices or cgroup isolation

Install Docker Engine: docs.docker.com/engine/install

The demo stack uses Docker Compose V2 (docker compose, not docker-compose):

docker compose version

Expected: Docker Compose version v2.x.x

Python and uv¶

Required for the Python adapter (adapters/python/) and the demo agent (demo/agent_py/):

Tool	Minimum version	Purpose
Python	3.12	Adapter runtime and demo agent
`uv`	latest	Fast package management for `adapters/python/`

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh
source "$HOME/.local/bin/env"

Install adapter dependencies:

cd adapters/python && uv sync --all-extras

cosign¶

Required for OCI artifact signing/verification and the failure-injection drills:

cosign version

Install: docs.sigstore.dev/cosign/installation

Demo keys (no passphrase) are pre-committed at demo/keys/cosign.{key,pub} for local use.

Optional: Network Tools for FI Shell Tests¶

Some edge FI shell tests require elevated privileges or kernel networking tools:

Tool	Package	Required for
`tc`	`iproute2`	FI-C4-02 retry-under-latency shell test
`CAP_NET_ADMIN`	—	Applying `tc` qdisc rules
Root / `sudo`	—	FI-C1-01 loop-device disk-full test

Without these, the tests that require them are automatically skipped (not failed) by the FI test harness.

Summary Checklist¶

go version → 1.25 or later
make --version → GNU Make 4.x or later
docker compose version → V2
python3 --version → 3.12 or later (for adapter/demo work)
cosign version → installed (for signing/verification drills)