Python SDK and fleetctl

Python SDK and fleetctl

pip install open-agent-fleet

One install, two things: the agentfleet Python package and the fleetctl CLI. (The pip name and the import name differ on purpose — agentfleet on PyPI belongs to an unrelated project. Same pattern as beautifulsoup4/bs4.)

Python

from agentfleet import FleetClient

fleet = FleetClient("http://localhost:8080", token="your-api-token")

bot = fleet.deploy_bot("cyber_ops", name="security-auditor")
task = bot.run("Audit the login page of staging.example.com for weak headers")
print(task.wait().summary)

API tokens are minted in the console under your account (or bootstrap one with fleetctl login).

fleetctl

fleetctl [--url URL] [--token TOKEN] <command>

Command	Does
doctor / diagnostics	Is the orchestrator healthy, what's connected
login / config	Store the URL and token
list / ps / inspect	Fleet state
deploy / run	Provision a bot; hand it a goal
host	Attach this PC to your sessions with Oaf, and run the Claude Code, Codex or Hermes agents that live on it: fleetctl host --root <folder> polls for work and asks in the terminal before running a command, writing a file or starting an agent run (--yes to skip asking)
devices	Your PCs and phones, and the agent CLIs each has
agent add / agent set	Add a Claude Code, Codex, Hermes, OpenClaw or webhook agent; change an agent's title, manager, trust, budget or connection
tickets / ticket	List tickets; file, show, comment on, reopen or move one
org	The org chart as a tree
fleet export / fleet import	The fleet as a template, without secrets
swarm	Multi-agent swarms
pipeline	Parallel DAG pipelines
vault	The shared work catalog
mcp	MCP servers: register, list, call
models	Providers and discovery
webhooks	Inbound trigger endpoints
financials	Cost telemetry
hub / voice	Work hub, TTS voices

fleetctl <command> --help shows each command's flags. The org chart, tickets and external agents are walked through in Org-Chart-Tickets-and-External-Agents.

From a checkout instead

pip install -e OpenAgentFleet/sdk/python

The SDK's test suite runs with python -m unittest discover -s tests inside sdk/python/.