Metadata-Version: 2.4
Name: alloy-runtime-sdk
Version: 0.2.63
Summary: Python SDK for Alloy Runtime - client, pipeline, and logging
Keywords: alloy,api,client,python,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: httpx==0.28.1
Requires-Dist: pydantic==2.12.5
Requires-Dist: structlog==25.5.0
Requires-Dist: alloy-runtime-types==0.2.63
Requires-Dist: uuid-extension==0.2.0
Requires-Dist: psycopg[binary]==3.3.3

# alloy-runtime-sdk

Python SDK for Alloy Runtime.

## Install

```bash
pip install alloy-runtime-sdk
```

## Quick start

```python
from alloy_runtime_sdk.api_client.client import ApiClient

async def main() -> None:
    async with ApiClient(
        base_url="https://your-alloy-runtime-host",
        api_key="your_api_key",
    ) as client:
        models = await client.list_models()
        print(models)
```

## What it includes

- Authenticated HTTP client methods for the Alloy Runtime API.
- Pipeline runtime helpers for Python-based pipeline steps.
- Structured logging helpers used by runtime integrations.

## Local pipeline runner

The SDK supports both Hosted execution and SDK local execution for pipelines.

Use `python -m alloy_runtime_sdk.pipeline.local_runner` to run a local pipeline module against a hosted Alloy Runtime, or call `run_local_pipeline()` directly from Python.

See `docs/pipelines/local_testing.md` for the full workflow and examples.

The SDK depends on `alloy-runtime-types`, which is published separately for stable,
versioned cross-package compatibility.
