agentd
Run agents behind the OpenAI client API, sandboxed.
- PTC: the model writes bash/python fences instead of JSON tool calls; MCP servers and
@toolfunctions show up as skills. - Harnesses: run Claude Code, Codex, OpenCode or omp through the same API and switch between them mid-conversation.
- Sandboxes: all agent code runs in a libkrun microVM or a Docker container, with no network and no credentials.
- Egress: optional network access through a host proxy that injects fnox secrets, so the sandbox never holds them.
- agentd serve: sessions, background turns and schedules as an API, reachable from other boxes over p2claw.
Install
uv add agentd
Then set up a sandbox:
# macOS (Apple Silicon)
brew tap slp/krun
brew trust --formula slp/krun/libkrun slp/krun/libkrunfw slp/krun/virglrenderer-krun
brew install slp/krun/libkrun
python -m agentd.sandbox.rootfs build agents # base image (needs Docker)
# Linux (KVM)
agentd-sandbox linux setup
# macOS via Colima (M3+, macOS 15+)
agentd-sandbox colima setup
# or Docker
python -m agentd.sandbox.rootfs build agents
Wheels for macOS arm64 and Linux x86_64/aarch64 include the launcher, agentd-net and (for Linux and Colima) libkrun, so nothing gets compiled. From a checkout, run agentd/sandbox/build.sh first.
agentd-sandbox status shows what's ready. Details, custom images and mounts: docs/sandboxes.md.
PTC
from agentd import patch_openai_with_ptc, display_events, tool
from openai import OpenAI
@tool
def calculate(expression: str) -> str:
"""Evaluate a math expression."""
return str(eval(expression, {"__builtins__": {}}))
client = patch_openai_with_ptc(OpenAI(), cwd="./workspace")
stream = client.responses.create(model="claude-sonnet-5", input="List files, then calculate 12*12", stream=True)
for event in display_events(stream):
if event.type == "text_delta":
print(event.text, end="")
elif event.type == "code_execution":
print(f"\n$ {event.code}\n{event.output}")
More: docs/ptc.md.
Harnesses
client = patch_openai_with_ptc(OpenAI(), cwd="./workspace", harness="claude-code")
r = client.responses.create(model="claude-sonnet-5", input="Add a test for utils.py and run it")
r = client.responses.create(input="Review that test", previous_response_id=r.id, harness="codex")
harness= is "ptc" (default), "claude-code", "codex", "opencode" or "omp". Each runs the real CLI inside the sandbox; credentials stay on the host behind a proxy. agentd.available(client) says which harnesses are ready and what models they have. Resume, transcripts, custom model servers: docs/harnesses.md.
Network and secrets
from agentd import KrunExecutor
from agentd.egress import Egress
from agentd.egress.approvals import Approvals
executor = KrunExecutor(egress=Egress(
allow=["pypi.org", "files.pythonhosted.org"],
approvals=Approvals(webhook="https://approver.example/hook"),
))
Sandboxes get placeholders; the proxy swaps in real values from fnox only for the hosts, methods and paths its rules allow. Anything else is refused or sent to your approval webhook. libkrun only. docs/egress-and-secrets.md.
agentd serve
agentd serve
Serves sessions over Unix sockets: turns, background runs, schedules, transcripts. Other boxes reach it over p2claw, and agentd.remote.Fleet drives them. docs/agentd-serve.md.
Plain tool calling
patch_openai_with_mcp(OpenAI()) runs MCP tool calls in a regular tool_calls loop with any LiteLLM provider, and uvx agentd config.yaml runs YAML-configured agents that react to MCP resource changes. docs/tool-calling.md.
Coming from 0.8: docs/upgrading-0.9.md.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for agentd 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentd-0.12.0.tar.gz | 4.9 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| agentd-0.12.0-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details |
| agentd-0.12.0-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details |
| agentd-0.12.0-py3-none-macosx_14_0_arm64.whl | Python 3 | none | macOS 14.0+ ARM64 | Details |
| agentd-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.3 MB
Release files / agentd-0.12.0.tar.gz
| Download URL | agentd-0.12.0.tar.gz |
|---|---|
| Size | 4.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c2d8e72f1ae573cc108c2da01cecd1b6e79bdb07e339e379fa78d7c5bbab1acc
|
|
BLAKE2b-256 checksum How to use checksums |
8e9652bbc7e427c79cb1266653ff4313e254b28fcd4c016006fb7cbff0f936d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / agentd-0.12.0-py3-none-manylinux_2_28_x86_64.whl
| Download URL | agentd-0.12.0-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
d620b6627c175081865dd8e1091b54d085e420e12a2cbcfea4025e10deea6b90
|
|
BLAKE2b-256 checksum How to use checksums |
78bd948976b938b9d75fa93f8e6c5a01aaeddea058e17baa519ce1b69904e9d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / agentd-0.12.0-py3-none-manylinux_2_28_aarch64.whl
| Download URL | agentd-0.12.0-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
44011e11d45444a03493bc57db2996817d3525e910d9854a5f68d5e6d550f388
|
|
BLAKE2b-256 checksum How to use checksums |
08bc605cb5c5a828fc339d0c6df63ae906a1e8f7d192d6a0f64c7e8ccebbc93f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / agentd-0.12.0-py3-none-macosx_14_0_arm64.whl
| Download URL | agentd-0.12.0-py3-none-macosx_14_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c2e0743a533708d97252a4269fdaf3a33fea9ad3b44a0df02def6563cd150595
|
|
BLAKE2b-256 checksum How to use checksums |
1370929e4a08730dde7bf0d9807db302cf7f8e2f83440bcf34a375e39e703c63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency logRelease files / agentd-0.12.0-py3-none-any.whl
| Download URL | agentd-0.12.0-py3-none-any.whl |
|---|---|
| Size | 278.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3d58295178232149896a2e28a7d6a807bacbbfa6d9df06e038cfac2c00b7497d
|
|
BLAKE2b-256 checksum How to use checksums |
baba46e50cf8e6ef9590e8f851d43c8c4a18fbd965f141c6a8cb374921edbde0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.
Transparency log
