Metadata-Version: 2.4
Name: planir
Version: 0.1.0b0
Summary: Official Python SDK for planir.io — hosted, hardware-isolated microVM runtimes with a stable public URL per runtime.
Project-URL: Homepage, https://planir.io
Project-URL: Repository, https://github.com/Planir-io/sdk
License-Expression: Apache-2.0
Keywords: agents,microvm,planir,runtime,sandbox,sdk
Requires-Python: >=3.9
Requires-Dist: httpx>=0.21.2
Requires-Dist: pydantic>=2.0
Requires-Dist: typing-extensions>=4.0
Description-Content-Type: text/markdown

# planir

Official Python SDK for [planir.io](https://planir.io) — hosted, hardware-isolated
microVM runtimes with a stable public URL per runtime. Sync and async clients.

## Install

```sh
pip install planir
```

## Usage

```python
import os
from planir import PlanirClient

client = PlanirClient(token=os.environ["PLANIR_TOKEN"])

# List runtimes
page = client.runtimes.list()
for runtime in page:
    print(runtime.id)

# Create a runtime
runtime = client.runtimes.create(image="ghcr.io/acme/agent:latest")
print(runtime.urls)
```

The client defaults to `https://api.planir.io`; pass `base_url` or `environment` to
override. An async client is available as `AsyncPlanirClient`. `client.runtimes.exec(...)`
runs synchronously; `client.runtimes.exec_detached(...)` returns an exec id you poll with
`client.runtimes.get_exec(...)`.

## License

Apache-2.0
