Metadata-Version: 2.4
Name: kestrel-cloud-vastai
Version: 0.2.0
Summary: Vast.ai GPU marketplace provider for Kestrel Sovereign — provision spot/on-demand GPU instances, run training jobs, lifecycle management
Project-URL: Homepage, https://kestrelsovereign.com
Project-URL: Source, https://github.com/KestrelSovereignAI/kestrel-cloud-vastai
Project-URL: Issues, https://github.com/KestrelSovereignAI/kestrel-cloud-vastai/issues
Author: UncleSaurus
Maintainer: UncleSaurus
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,gpu,kestrel,lora,marketplace,training,vastai
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.6
Requires-Dist: vastai-sdk>=0.1.0
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-vastai

Vast.ai GPU marketplace provider for Kestrel Sovereign agents. Search the marketplace, provision spot/on-demand GPU instances, run training over SSH, manage lifecycle.

## Installation

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

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

## Configuration

| Variable | Description |
|----------|-------------|
| `VASTAI_API_KEY` | Vast.ai API key (required) |

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

## What's provided

- `VastAIFeature` — agent-facing tools for instance search, provisioning, SSH training, lifecycle
- Standalone API: `VastAIManager` for direct programmatic use
- HTTP API + SSH-training helpers

## Dependencies

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

## Development

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

## License

Apache-2.0
