The Agentix CLI has one verb:
  • agentix build turns a Python project into a deploy-ready runtime image.
agentix --help
agentix build --help

agentix build

Package one project root into a bundle image.
agentix build
agentix build path/to/project
agentix build . --name my-rollout:0.1.0
agentix build . --platform linux/amd64
agentix build . --dry-run
The project root must contain pyproject.toml. The default image tag is derived from [project].name and [project].version; -n / --name overrides it.
OptionMeaning
pathProject root, default .
-n, --nameImage NAME or NAME:TAG; bare names use [project].version
--platformSandbox runtime platform, linux/amd64 or linux/arm64; defaults to local CPU
--dry-runStage the Dockerfile and build context without running Docker
--platform describes the Linux container platform where the sandbox will run, not the machine that invokes the build. For example, use --platform linux/amd64 when building on an Apple Silicon Mac for a remote x86 sandbox.

Dependency Model

The CLI never enumerates integrations. It installs the project into the runtime venv, and pip resolves everything declared by the project.
pyproject.toml
[project]
name = "my-rollout"
version = "0.1.0"
dependencies = [
    "agentixx>=0.1.0",
    "agentix-runtime-basic>=0.1.0",
    "agentix-claude-code>=0.1.0",
    "agentix-swebench>=0.1.0",
]
That project builds one image containing the framework, sandbox primitives, the agent wrapper, the scorer wrapper, transitive deps, and the project itself.

Dry Run

agentix build . --dry-run
Dry run stages the generated Dockerfile and copied project tree under ./build/<tag>/, prints what would be built, and exits without invoking Docker.

Configuration

Most configuration is environment-driven so CLI and code paths stay the same.
VariableUsed byPurpose
AGENTIX_BIND_PORTruntime serverSandbox-side bind port, default 8000
AGENTIX_UPLOAD_ROOTfile primitive packagesSandbox-side root for file operations
DAYTONA_API_KEYdaytona backendAPI authentication
E2B_API_KEY / E2B_TEMPLATE_IDe2b backendAPI authentication and template selection
Third-party packages that need their own top-level workflow should ship a separate console script such as agentix-yourcmd instead of expanding the core CLI.