Install Agentfield CLI

One command. No Docker required. No complex setup.

curl -sSf https://agentfield.ai/get | sh

Reload your shell configuration:

source ~/.zshrc  # or ~/.bashrc for bash users

Verify Installation

af --version

You should see output like:

AgentField Control Plane
  Version:    0.1.8
  Commit:     fb9f5e2
  Built:      2025-11-17T23:03:17Z
  Go version: go1.24.2
  OS/Arch:    darwin/arm64

Install Python SDK

For Python agents, install the Agentfield SDK:

pip install agentfield --upgrade

Python Version

AgentField requires Python 3.8 - 3.13. If you need to install Python:

# Install uv (fast Python installer)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a virtual environment with Python 3.13
uv venv --python 3.13
source .venv/bin/activate

# Install AgentField
uv pip install agentfield

Python 3.14 is not supported due to gRPC compatibility issues with dependencies. Use Python 3.8-3.13.

System Requirements

macOS (Intel or Apple Silicon)
Linux (x86_64 or ARM64)
Python 3.8 - 3.13 (for Python agents)
Go 1.21+ (for Go agents)

The Agentfield server runs natively on your machine. No containers required for local development.

Platform-Specific Notes

Linux

Ensure curl is installed:

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y curl

# RHEL/CentOS
sudo yum install -y curl

macOS

No additional setup required. The installer works on both Intel and Apple Silicon.

Troubleshooting

Command not found after installation?

The installer automatically configures your PATH. Reload your shell:

source ~/.zshrc  # or ~/.bashrc for bash users

If the issue persists, verify ~/.agentfield/bin is in your PATH:

echo $PATH | grep agentfield

Permission denied?

Check your user permissions for ~/.agentfield/bin.

Installation fails on Ubuntu?

Ubuntu uses dash instead of bash for /bin/sh. Use bash explicitly:

curl -sSf https://agentfield.ai/get | bash

Installation