Metadata-Version: 2.4
Name: sandflare
Version: 0.1.1
Summary: Sandflare Python SDK for sandboxes and managed Postgres
License: MIT
Project-URL: Homepage, https://sandflare.io
Project-URL: Documentation, https://docs.sandflare.io
Keywords: sandflare,sandbox,microvm,postgres,firecracker
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Sandflare Python SDK

The official Python SDK for creating and managing Sandflare sandboxes and managed Postgres databases.

## Install

```bash
pip install sandflare
```

For local development:

```bash
pip install -e sdk/python/
```

## Quick start

```python
from sandflare import Sandbox

sandbox = Sandbox.create("agent")
sandbox.run_code("value = 10")
result = sandbox.run_code("value += 5\nprint(value)")
print(result.stdout)
```

## Environment variables

- `SANDFLARE_API_KEY`: preferred API key
- `SANDFLARE_API_URL`: optional API base URL override
- `PANDAAGENT_API_KEY`: legacy API key alias
- `PANDAAGENT_BASE_URL`: legacy base URL alias

## Build locally

```bash
cd sdk/python
python3 -m pip wheel . --no-deps -w dist/
```

## Publish to PyPI

```bash
cd sdk/python
rm -rf dist/
python3 -m pip wheel . --no-deps -w dist/
python3 -m twine upload dist/*
```

Use a PyPI API token via `TWINE_USERNAME=__token__` and `TWINE_PASSWORD=<pypi-token>`.
