Arga provides official SDKs for Python and TypeScript. Both cover the same API surface — choose whichever fits your stack.Documentation Index
Fetch the complete documentation index at: https://docs.argalabs.com/llms.txt
Use this file to discover all available pages before exploring further.
Python
Sync and async support. Works with any Python 3.10+ project.
TypeScript
Zero dependencies. Uses native fetch (Node 18+).
What the SDKs cover
Both SDKs wrap the same set of endpoints:| Namespace | What it does |
|---|---|
| Runs | Start URL, PR, and agent validation runs. Poll or stream results. Cancel runs. |
| Twins | Provision standalone digital twin environments. Check readiness. Extend TTL. |
| Scenarios | Create and list reusable twin seed configurations. |
Authentication
All SDK methods require an API key. Get one by running:Example projects
Both SDK repositories include a set of ready-to-run scripts that demonstrate real-world workflows — release gating, scenario creation, twin provisioning, and autonomous agent exploration. Each script has a configuration block at the top that you can adapt to your own environment.| Example | What it does |
|---|---|
| Validate staging release | Run browser validation against staging and exit non-zero if it fails — drop it into CI to gate releases. |
| Create checkout scenario | Build a reusable scenario with seed data and tags so your team can replay the same flow across runs. |
| Provision checkout twins | Spin up disposable service twins (e.g. Stripe), wait until ready, and print the URLs and env vars. |
| Explore staging with agent | Deploy an autonomous agent that explores your app and returns a story, results, and red-team report. |
Python examples
uv run python examples/validate_staging_release.pyTypeScript examples
npx tsx examples/validate_staging_release.tsBase URL
Both SDKs default tohttps://api.argalabs.com. Override this if you’re targeting a different environment: