Actuate Python API
Actuate runs coding agents in interactive worlds and keeps their workspaces, transcripts, checkpoints, recordings, and logs together.
Install
python -m pip install actuate-agents
The distribution is named actuate-agents; the Python package is imported as
actuate:
from actuate import Agent, World, default_system_prompt
world = World(dir="path/to/world")
world.start(port=8080, record=True)
agent = Agent(agent="codex", name="Rocky", model="gpt-5.5")
world.connect(agent=agent)
agent.start(
initial_prompt="Begin.",
system_prompt=default_system_prompt(),
)
Precompiled wheels support CPython 3.8 and newer on Linux and macOS. Installing a wheel does not require Rust or Node.js.
The wheel also installs the native Actuate command and its production web application:
actuate app
Actuate launches agent-provider commands such as codex, claude, or kimi.
Install the provider CLI you intend to use. The default process multiplexer is
tmux; alternatively configure a supported herdr installation.
License
Actuate is proprietary software. The package may be installed and used under
the terms in the included LICENSE; redistribution, modification, and access
to the private source repository are not granted.
Build from source
Source builds are for Actuate contributors and require Rust, Node.js 18 or newer, and npm:
cd app
npm ci
npm run build
cd ../python/actuate
bash scripts/stage-cli.sh "$(rustc -vV | sed -n 's/^host: //p')"
Then build and install the development package:
maturin develop
pytest
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 13.9 MB
- Tags: CPython 3.8+, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a0a355e58da5bee87231fb6d11ca30a78085f4b5c424f4e9564f952f499afe75
|
|
| MD5 |
3ba038ee6c57f276460326c8a7b3a8d5
|
|
| BLAKE2b-256 |
d1cce21ea555d8dca17d043a3bf8cfe4746bad75d5fdb9877ed806be72c91b90
|
Provenance
The following attestation bundles were made for actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:
Publisher:
release-python.yml on nacloos/actuate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl -
Subject digest:
a0a355e58da5bee87231fb6d11ca30a78085f4b5c424f4e9564f952f499afe75 - Sigstore transparency entry: 2240053358
- Sigstore integration time:
-
Permalink:
nacloos/actuate@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Branch / Tag:
refs/tags/python-v0.1.2 - Owner: https://github.com/nacloos
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 13.8 MB
- Tags: CPython 3.8+, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
265950b95bed55b33198fe71ec6362e7cbf303650a7cfb9addb80dec45a0a08d
|
|
| MD5 |
8b5e6aeaa2a50bfc96e15cd2b583cc22
|
|
| BLAKE2b-256 |
3395f52670ede83b22f34218b4255ecedacbee92b3a8a4d1edc55bf91fd53a8f
|
Provenance
The following attestation bundles were made for actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:
Publisher:
release-python.yml on nacloos/actuate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
actuate_agents-0.1.2-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl -
Subject digest:
265950b95bed55b33198fe71ec6362e7cbf303650a7cfb9addb80dec45a0a08d - Sigstore transparency entry: 2240052997
- Sigstore integration time:
-
Permalink:
nacloos/actuate@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Branch / Tag:
refs/tags/python-v0.1.2 - Owner: https://github.com/nacloos
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file actuate_agents-0.1.2-cp38-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: actuate_agents-0.1.2-cp38-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 13.0 MB
- Tags: CPython 3.8+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
21588d82d7f5cc75cb346b8faefe69045e594d58904325c5bb03fc84fc72be84
|
|
| MD5 |
7dec04561cadb0e887fa76847e715f2b
|
|
| BLAKE2b-256 |
1d9fdcdb8ff67410c7122ee6f1b571e42e5a37f0bc7ddb41295696fed4edc542
|
Provenance
The following attestation bundles were made for actuate_agents-0.1.2-cp38-abi3-macosx_11_0_arm64.whl:
Publisher:
release-python.yml on nacloos/actuate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
actuate_agents-0.1.2-cp38-abi3-macosx_11_0_arm64.whl -
Subject digest:
21588d82d7f5cc75cb346b8faefe69045e594d58904325c5bb03fc84fc72be84 - Sigstore transparency entry: 2240054026
- Sigstore integration time:
-
Permalink:
nacloos/actuate@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Branch / Tag:
refs/tags/python-v0.1.2 - Owner: https://github.com/nacloos
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file actuate_agents-0.1.2-cp38-abi3-macosx_10_12_x86_64.whl.
File metadata
- Download URL: actuate_agents-0.1.2-cp38-abi3-macosx_10_12_x86_64.whl
- Upload date:
- Size: 13.3 MB
- Tags: CPython 3.8+, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b712f8cac7469a426bc8f2b682452279dfbe365a8b57369a697aa5f927f032a6
|
|
| MD5 |
acc9710d9140afab92e2bf905638ffe7
|
|
| BLAKE2b-256 |
1bdae6897fde152f9f52f18a997107bc5990bac72d1bd45601d9d4405dcd40e3
|
Provenance
The following attestation bundles were made for actuate_agents-0.1.2-cp38-abi3-macosx_10_12_x86_64.whl:
Publisher:
release-python.yml on nacloos/actuate
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
actuate_agents-0.1.2-cp38-abi3-macosx_10_12_x86_64.whl -
Subject digest:
b712f8cac7469a426bc8f2b682452279dfbe365a8b57369a697aa5f927f032a6 - Sigstore transparency entry: 2240052854
- Sigstore integration time:
-
Permalink:
nacloos/actuate@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Branch / Tag:
refs/tags/python-v0.1.2 - Owner: https://github.com/nacloos
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@76d93042ba36669ad2376a5562c6cd2cb3f4cdf8 -
Trigger Event:
push
-
Statement type: