Quickstart

Deploy your first agent or sandbox in 5 minutes

Prerequisites

You need a Hexel Studio account and an API key. Create both at console.hexelstudio.com.

Generate an API key under IAM → Service Users → Create API Key.

Install

Python

pip install hexel

TypeScript

npm install hexel-sdk

CLI

curl -fsSL https://hexelstudio.com/install.sh | bash
export HEXEL_API_KEY="your_api_key"

Run code in a sandbox

Sandboxes are isolated environments allocated instantly.

Python

from hexel import Hexel

client = Hexel(api_key="your_api_key")

sandbox = client.compute.sandbox.create(tier="standard")
print(sandbox["vm_id"])

client.compute.sandbox.execute(
    sandbox["vm_id"],
    code="print('Hello from Hexel')",
    language="python"
)

client.compute.sandbox.release(sandbox["vm_id"])

TypeScript

import { Hexel } from "hexel-sdk";

const client = new Hexel({ apiKey: "your_api_key" });

const sandbox = await client.compute.sandbox.create({ tier: "standard" });
console.log(sandbox.vm_id);

CLI

hexel compute sandbox create --tier standard
hexel compute sandbox exec <vm-id> --code "print('Hello from Hexel')"
hexel compute sandbox release <vm-id>

Deploy an agent

Register a Docker image and deploy it with a permanent endpoint.

Python

from hexel import Hexel

client = Hexel(api_key="your_api_key")

agent = client.compute.agent.register(
    name="my-agent",
    image="ghcr.io/your-org/agent:v1",
    capabilities=["chat", "streaming"],
)

instance = client.compute.instance.deploy(
    agent["id"],
    env={"MODEL": "gpt-4"}
)

print(instance["endpoint"])
# https://zeal-isle-a620.compute.hexelstudio.com

CLI

hexel compute agent register \
  --name my-agent \
  --image ghcr.io/your-org/agent:v1 \
  --capabilities "chat,streaming"

hexel compute instance deploy <agent-id>

Your agent is live at a permanent URL. Same configuration always produces the same endpoint.

Call your agent

curl -N https://zeal-isle-a620.compute.hexelstudio.com/stream \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello"}'

Next steps

Sandboxes

Isolated execution environments.

Agents

Register and manage agent images.

Instances

Deploy with permanent endpoints.