Harakiri Python SDK

Typed synchronous and asynchronous clients for the Harakiri sandbox control plane. Developer preview, version 0.1.0rc1, for Python 3.11 or newer. See the release record for publication status, exact artifacts and native qualification evidence.

The SDK talks only to the Harakiri API. It does not require Node, Kubernetes credentials, a runtime-provider SDK or an agent framework.

Version-pinned PyPI installation:

python -m pip install "h-sandbox==0.1.0rc1"

from harakiri import HarakiriClient

with HarakiriClient.from_env() as client:
    with client.sandboxes.task(template="your-installed-template") as sandbox:
        result = sandbox.run("printf 'hello\\n'", check=True)
        print(result.stdout)

Set HARAKIRI_API_URL and HARAKIRI_API_KEY privately. Closing the client closes connections, not sandboxes. The explicit task context owns a newly created sandbox and confirms termination and capacity release on exit. connect borrows an existing sandbox and never deletes it automatically.

See the Python guide for the supported surface, installation, request deadlines, partial outcomes and release qualification status. For asyncio, use AsyncHarakiriClient, async with and awaited resource methods. No event-loop bridge or model dependency is required by the asynchronous API. Python 3.11 is the minimum.