Metadata-Version: 2.4
Name: actuate-agents
Version: 0.1.3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Dist: h5py>=3.8
License-File: LICENSE
Summary: Python orchestration API for Actuate
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# Actuate Python API

Actuate runs coding agents in interactive worlds and keeps their workspaces,
transcripts, checkpoints, recordings, and logs together.

## Install

```bash
python -m pip install actuate-agents
```

The distribution is named `actuate-agents`; the Python package is imported as
`actuate`:

```python
from actuate import Agent, World, default_system_prompt

world = World(dir="path/to/world")
world.start(port=8080, record=True)

agent = Agent(
    "codex",
    name="Rocky",
    model="gpt-5.5",
    version="0.42.0",
)
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.

The wheel also installs the native Actuate command and its production web
application:

```bash
actuate app
```

Actuate launches agent-provider commands such as `codex`, `claude`, or `kimi`.
When a provider CLI is missing, Actuate asks before installing it. Use
`install="if-missing"` in an unattended script or `install="never"` to disable
installation. A `version` is an exact, verified CLI pin. 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`.