Metadata-Version: 2.4
Name: kestrel-cloud-runpod
Version: 0.2.0
Summary: RunPod GPU cloud provider for Kestrel Sovereign — provision pods, run training jobs, lifecycle management
Project-URL: Homepage, https://kestrelsovereign.com
Project-URL: Source, https://github.com/KestrelSovereignAI/kestrel-cloud-runpod
Project-URL: Issues, https://github.com/KestrelSovereignAI/kestrel-cloud-runpod/issues
Author: UncleSaurus
Maintainer: UncleSaurus
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,gpu,kestrel,lora,runpod,training
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Distributed Computing
Requires-Python: <3.14,>=3.11
Requires-Dist: kestrel-sovereign-sdk<1,>=0.4
Requires-Dist: kestrel-sovereign<1,>=0.7
Requires-Dist: runpod>=1.8.1
Provides-Extra: test
Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Description-Content-Type: text/markdown

# kestrel-cloud-runpod

RunPod GPU cloud provider for Kestrel Sovereign agents. Provision pods, run LoRA training, manage pod lifecycle, plus a RunPod-backed Ollama provider.

## Installation

```bash
uv pip install kestrel-cloud-runpod
```

The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.features` entry point — install it alongside `kestrel-sovereign` and `RunPodFeature` registers itself at startup.

## Configuration

| Variable | Description |
|----------|-------------|
| `RUNPOD_API_KEY` | RunPod API key (required) |

Optional `[runpod]` section in `kestrel.toml` for default profile preferences.

## What's provided

- `RunPodFeature` — agent-facing tools for pod search, provisioning, training, lifecycle
- Standalone API: `RunPodManager` for direct programmatic use
- RunPod-backed Ollama integration (when running large models on rented GPUs)

## Dependencies

- `kestrel-sovereign-sdk>=0.2,<1` — base `Feature`, `tool`, `ToolCategory`, `BackendType`
- `kestrel-sovereign>=0.7,<1` — `kestrel.toml` unified-config loader (runtime)
- `runpod>=1.8.1`

## Development

```bash
uv pip install -e '.[test]'
uv run pytest
```

## License

Apache-2.0
