Metadata-Version: 2.5
Name: stackgen-sdk
Version: 0.1.1
Summary: StackGen SDK — Aiden, SRE, and Vault from one client
Project-URL: Homepage, https://github.com/appcd-dev/stackgen-sdk
Project-URL: Documentation, https://github.com/appcd-dev/stackgen-sdk/tree/main/docs
Project-URL: Repository, https://github.com/appcd-dev/stackgen-sdk
Project-URL: Issues, https://github.com/appcd-dev/stackgen-sdk/issues
Author: StackGen
License-Expression: Apache-2.0
Keywords: aiden,openapi,sre,stackgen
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0
Requires-Dist: python-dateutil>=2.8
Requires-Dist: typing-extensions>=4.0
Requires-Dist: urllib3>=2.0
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# StackGen Python SDK

Install (PyPI):

```bash
pip install stackgen-sdk==0.1.1
```

Developers with private repo access:

```bash
pip install "git+ssh://git@github.com/appcd-dev/stackgen-sdk.git@v0.1.1#subdirectory=clients/python"
```

Quick start:

```python
from stackgen import StackgenClient

client = StackgenClient.from_env()
result = client.aiden.run_webhook_and_download_report(open("alert.json").read())
print(result.session_id, result.output_path)

alerts = client.sre.list_alerts()
```

Environment:

| Variable | Purpose |
|----------|---------|
| `STACKGEN_URL` | Mothership URL (no `/guild`) |
| `STACKGEN_TOKEN` | API token (`stackgen_…`) |
| `WEBHOOK_TOKEN` | Webhook token (`sg_aios_…`) for triggers |
| `ORG_ID` | Organization UUID |
| `WEBHOOK_ID` | Optional; older trigger 202 bodies |

See [docs/PRODUCT.md](../../docs/PRODUCT.md), [docs/python/IMPLEMENTATION.md](../../docs/python/IMPLEMENTATION.md), and [docs/PUBLISH.md](../../docs/PUBLISH.md).

Generated OpenAPI client code lives under `stackgen.generated` (unstable; prefer `StackgenClient`).
