CAVE — Code Agent Virtualization Environment
Package: cave-harness
CAVE virtualizes any terminal-based code agent (e.g. Claude Code) behind an HTTP server, so it can be driven, observed, and orchestrated as a service instead of an interactive terminal. It is the agent runtime that PromptWorld and the other *Worlds are built on.
What it gives you
- An HTTP server around a code agent — start a long-lived agent process and talk to it over HTTP instead of a TTY: inject prompts, stream output, and run it inside a loop.
- A hook harness — a registry + dispatch layer for Claude Code hooks (session-start / per-turn / stop), so behavior can be layered onto the agent from outside.
- Loop infrastructure — the autopoiesis / guru loops that keep an agent working across turns.
Install
pip install cave-harness
Optional extras:
pip install "cave-harness[sdna]" # + sanctuary-dna integration
pip install "cave-harness[dev]" # + pytest / pytest-asyncio
Run the server
cave-server
This launches the HTTP server (cave.server.http_server:run_server, FastAPI + uvicorn). Point your
client at it to register hooks, inject prompts, and drive the virtualized agent.
Where it sits
CAVE is the runtime layer of the SANCREV / GNOSYS stack: the *Worlds (PromptWorld, …) compile their agents and run them on top of the CAVE harness. See the ecosystem docs for the full picture.
Docs
Full documentation and the ecosystem map: https://sancovp.github.io/aisaac/
License
GPBL-1.0 — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for cave-harness 0.1.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 | Provenance | |
|---|---|---|---|---|
| cave_harness-0.1.0.tar.gz | 174.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cave_harness-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 381.2 kB
Release files / cave_harness-0.1.0.tar.gz
| Download URL | cave_harness-0.1.0.tar.gz |
|---|---|
| Size | 174.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
64018da4ce10edd11bc977866841c5912b0dc87f062e4f1cf521f7aede35badc
|
|
BLAKE2b-256 checksum How to use checksums |
12e282d50506855df931007f2f8016848318a6101ea432d66499beeaa49e246f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / cave_harness-0.1.0-py3-none-any.whl
| Download URL | cave_harness-0.1.0-py3-none-any.whl |
|---|---|
| Size | 206.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8a8c5fe372e9252c84151664336e9bdf5450b329b658df4b69f2c7acac40963a
|
|
BLAKE2b-256 checksum How to use checksums |
e440d56cf0885c25a02015cf86d710df0cce04551a3403b7ab9ffb7b2a7ac364
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Security for cave-harness 0.1.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
