Examples

# Deploy the instance
hexel compute instance deploy YOUR_AGENT_ID --env-file .env

from hexel import Hexel

client = Hexel(api_key="YOUR_API_KEY")

# List instances for the agent
instances = client.compute.instance.list(agent_id="YOUR_AGENT_ID")
for inst in instances:
    print(f"{inst['id']} — {inst['state']} — {inst['endpoint']}")

# Redeploy after a config change
client.compute.instance.redeploy(instances[0]["id"])

# Stop when done
client.compute.instance.stop(instances[0]["id"])

from hexel import Hexel

client = Hexel(api_key="YOUR_API_KEY")

sandbox = client.compute.sandbox.create(tier="large")
try:
    result = client.compute.sandbox.execute(
        sandbox["sandbox_id"],
        code="""
import json
data = [{"id": i, "value": i * 2} for i in range(100)]
print(json.dumps({"count": len(data), "total": sum(d["value"] for d in data)}))
""",
        language="python",
    )
    print(result)
finally:
    client.compute.sandbox.release(sandbox["sandbox_id"])

from hexel import Hexel

client = Hexel(api_key="YOUR_API_KEY")

task = client.orchestrator.task.create(
    fleet_id="YOUR_FLEET_ID",
    environment_id="YOUR_ENVIRONMENT_ID",
    workspace_id="YOUR_WORKSPACE_ID",
    input="Draft and send the weekly status email",
)

for event in client.orchestrator.task.stream(task["id"]):
    if event["type"] == "plan.review":
        approvals = client.orchestrator.approval.list()
        for a in approvals:
            client.orchestrator.approval.review(a["id"], decision="approve")
    elif event["type"] in ("task.complete", "task.failed"):
        print("Done:", event["type"])
        break

from hexel import Hexel

client = Hexel(api_key="YOUR_API_KEY")

# Validate inputs first
client.tools.preflight(
    tool_slug="GITHUB_CREATE_ISSUE",
    input={"repo": "your-org/repo", "title": "Investigate latency spike"},
)

# Execute
call = client.tools.execute(
    tool_slug="GITHUB_CREATE_ISSUE",
    input={"repo": "your-org/repo", "title": "Investigate latency spike"},
)
print(call)

from hexel import Hexel

client = Hexel(api_key="YOUR_API_KEY")

results = client.tools.batch([
    {"tool_slug": "SLACK_POST_MESSAGE", "input": {"channel": "#alerts", "text": "Deploy started"}},
    {"tool_slug": "SLACK_POST_MESSAGE", "input": {"channel": "#alerts", "text": "Deploy finished"}},
])
print(results)

from hexel.instrument import init, start_request, finish_request

init()  # Once at startup

start_request()
# ... your OpenAI / Anthropic calls happen here ...
telemetry = finish_request()
print(telemetry)