Resources

from hexel import Hexel

client = Hexel(
    api_key="YOUR_API_KEY",          # or client_id / client_secret
    timeout=30.0,                     # request timeout in seconds
)

sandbox = client.compute.sandbox.create(tier="standard")
agent = client.compute.agent.register(name="a", image="ghcr.io/org/a:v1")

# Manage instances (deploy via CLI or REST first)
instances = client.compute.instance.list(agent_id=agent["id"])
client.compute.instance.stop(instances[0]["id"])

task = client.orchestrator.task.create(
    fleet_id="YOUR_FLEET_ID",
    environment_id="YOUR_ENVIRONMENT_ID",
    workspace_id="YOUR_WORKSPACE_ID",
    input="Summarize the backlog",
)
client.orchestrator.approval.review("YOUR_APPROVAL_ID", decision="approve")

from hexel.instrument import init, start_request, finish_request

init()  # Call once at startup

start_request()
# ... your LLM calls ...
telemetry = finish_request()

for event in client.orchestrator.task.stream(task["id"]):
    print(event["type"], event.get("data"))

# Use a test-environment key in CI
client = Hexel(api_key=os.environ["HEXEL_TEST_API_KEY"])
sandbox = client.compute.sandbox.create(tier="micro")
try:
    result = client.compute.sandbox.execute(sandbox["sandbox_id"], code="print('ok')", language="python")
    assert "ok" in result["output"]
finally:
    client.compute.sandbox.release(sandbox["sandbox_id"])