Metadata-Version: 2.4
Name: zubbl-runtime
Version: 0.1.4
Summary: Core runtime client for Zubbl Runtime Guard
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.23; extra == "test"

# Zubbl Runtime

Core Python runtime client for Zubbl Runtime Guard.

`zubbl-runtime` provides the shared runtime, bootstrap, signing, policy enforcement, resilience and transport components used by the Zubbl framework adapters.

## Requirements

- Python 3.10+

## Installation

```bash
pip install zubbl-runtime
```

Most developers should install a framework adapter such as `zubbl-fastapi`, which installs this package automatically.

## API keys

Supply the API key through the application environment. Never place a real Zubbl key in source code, Git, logs or screenshots.

```bash
export ZUBBL_API_KEY="zubbl_sk_..."
```

For local development, use an uncommitted environment file loaded by your application. Hosted applications should use their platform-managed environment variables or secrets.

## Bootstrap errors

`BootstrapError.retryable` distinguishes temporary network, timeout, HTTP 408, HTTP 429 and HTTP 5xx failures from non-retryable credential or configuration errors. This bootstrap policy is separate from the remotely supplied `runtime_fail_mode`.
