Metadata-Version: 2.4
Name: caveman-sdk
Version: 1.0.0
Summary: Stdlib-only Python client for Caveman gateway tracing, tool deferral, checkpoints, and recoverable compression.
Author: Caveman
License-Expression: MIT
Project-URL: Homepage, https://caveman.so/docs/sdk/python
Project-URL: Repository, https://github.com/JuliusBrussee/caveman
Project-URL: Issues, https://github.com/JuliusBrussee/caveman/issues
Keywords: agents,ai,llm,observability,opentelemetry,optimization
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# caveman

Stdlib-only Python client for Caveman gateway cooperation.

Distribution name: `caveman-sdk`. Import package: `caveman_cloud`. Registry
publication remains release-gated; from this source directory install with:

```bash
python -m pip install -e .
```

```python
import os
from caveman_cloud import Cave

cave = Cave(
    api_key=os.environ["CAVE_API_KEY"],
    base_url="http://127.0.0.1:8787",
    agent="support-agent",
)

result = cave.compress("large payload")
print(result.output, result.basis)  # basis is inferred
```

Main surfaces: provider clients, `compress`, deferred tool search, reversible
checkpoints and artifacts, retry-loop interruption, runtime policy, and a
stdlib-only OTLP/JSON exporter. Async jobs are reserved and fail locally with
`cave_async_jobs_unavailable`; they send no request.

Requires Python 3.13 or newer. Package is MIT licensed. Connected calls need a
Caveman gateway key; local Engine compression remains accountless and ships
through the separate Caveman runtime.

See [Python SDK documentation](https://caveman.so/docs/sdk/python).
