StackGen SDK
Drive Aiden workflows from CI with Python or TypeScript — trigger webhooks, run Ask Guild, wait for sessions, download reports. All sample code is inline on this site.
Start here
| You want to… | Read |
|---|---|
| Understand terms (session, trace, webhook token, …) | Aiden guide → Glossary |
| Create a custom Agent + Workflow in code | Create a workflow |
| Trigger a workflow and download the session report | Webhook → session → artifact |
| Trigger a workflow from an alert webhook (narrative) | Webhook journey |
| Start work with natural language (Ask Guild) | Ask journey |
| Copy/paste full example scripts | Code samples (filterable; press ⌘K) |
| Async Ask / webhook workers | Async Ask worker · Async webhook worker |
| Quick API reference | Usage |
| Install, auth, webhooks, errors, reports | FAQ |
| Raw OpenAPI / Swagger YAML | Download stackgen.openapi.yaml |
Install
Pin a release in CI.
pip install stackgen-sdk==0.1.5
npm install stackgen-sdk@0.1.5Connect
Three mothership fields + optional webhook token.
base_url, api_token, org_id
webhook_token # webhooks onlyTwo paths
Webhook — alert POST with sg_aios_…
Ask — message + entity_refs with stackgen_…
Why this SDK?
StackGen’s Agentic OS for Ops runs governed automation across SRE, infrastructure, and observability. The SDK wraps the public Aiden HTTP surface so your pipelines can:
- Trigger a registered workflow (webhook or Ask)
- Wait until a
session_idexists and execution settles - Download artifacts such as
session-report.md
All sample code on this site is inline — copy it directly from your browser.