inis 0.1.0

Python SDK for inis.run agent sandboxes

inis.run Python SDK

Run untrusted or AI-generated code in its own isolated VM.

Install

pip install inis

Quickstart

from inis import Client

client = Client()  # reads INIS_API_KEY (and INIS_BASE_URL) from the environment

with client.session() as session:
    session.exec(["pip", "install", "httpx", "-q"])
    session.files.write("/workspace/out.txt", "hello")
    print(session.files.read("/workspace/out.txt"))

    preview = session.expose(8765)
    print(preview.preview_url)

# One-shot execution (throwaway session, no cleanup needed)
result = client.execute(language="python", code="print(42)")
print(result.stdout)

# Re-attach to a session created elsewhere, by ID
session = client.sessions.attach("ses_123")

client.session() returns a context manager that destroys the session on exit. Use client.sessions.create(...) directly if you want to manage its lifetime yourself, and client.sessions.attach(id) to reconnect to a session you don't own — that call never destroys it.

Timeouts

Client(timeout=...) and Session(timeout=...) are seconds (httpx convention). The TypeScript SDK's timeoutMs is milliseconds (JS convention) — a deliberate per-language idiom, not drift.

Links

• Docs: docs.inis.run
• Quickstart: docs.inis.run/docs/quickstart
• Source: github.com/inis-run/sdk/tree/main/python
• Homepage: inis.run

Built and run in the EU. Your code and data never leave Europe.

License

MIT — see LICENSE.