SDKs & CLI

The SDKs wrap the REST API so you can work in Python or TypeScript without constructing raw HTTP requests. They handle authentication, token refresh, and pagination for you. The CLI handles infrastructure tasks — deploying agents, managing sandboxes, checking usage — from your terminal. Pick whichever fits your workflow. Hexel Studio offers official SDKs for Python and TypeScript, plus two command-line tools. Each provides programmatic access to Compute, Orchestration, and the Tool Gateway, with authentication and token refresh handled automatically.

Choose your tool

Python SDK

pip install hexel — Python 3.10+

TypeScript SDK

npm install hexel-sdk — Node.js 18+

CLI (hexel)

Infrastructure and resource management from your terminal.

SDK coverage

Area	Python (`hexel`)	TypeScript (`hexel-sdk`)
Compute (sandboxes, agents, instances)	✓	✓
Orchestration (tasks, fleets, approvals, policies)	✓	✓
Tools (Tool Gateway)	`client.tools`	`client.orchestrator.tools`
Agent runtime helpers	`client.runtime`	`client.runtime`
LLM auto-instrumentation	`hexel.instrument`	—

There is no client.compute.instance.deploy() in either SDK. Deploy instances via the REST API or the hexel CLI. The SDKs manage instances after deployment (list, get, stop, redeploy, delete).

The Data Platform (knowledge, memory, connectors) is accessed via the REST API and Console, not the SDKs.

Two CLIs

Tool	For	Commands
`hexel`	Platform operators	`compute`, `fleet`, `task`, `tools`, `policy`, `approval`, `runtime`, `auth`

Authentication

All clients support both methods and read the same environment variables:

Python
TypeScript
CLI

from hexel import Hexel

client = Hexel(api_key="YOUR_API_KEY")
# or
client = Hexel(client_id="YOUR_CLIENT_ID", client_secret="YOUR_CLIENT_SECRET")

import { Hexel } from "hexel-sdk";

const client = new Hexel({ apiKey: "YOUR_API_KEY" });
// or
const client = new Hexel({ clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET" });

export HEXEL_API_KEY="YOUR_API_KEY"
hexel auth login

See Authentication for details on token exchange and refresh.

Next steps

Pick a tool above, or start with the Python SDK quickstart.

Overview

Python SDK

CLI (hexel-tools)

Choose your tool

Python SDK

TypeScript SDK

CLI (hexel)

SDK coverage

Two CLIs

Authentication

Next steps

​Choose your tool

Python SDK

TypeScript SDK

CLI (hexel)

​SDK coverage

​Two CLIs

​Authentication

​Next steps

Choose your tool

SDK coverage

Two CLIs

Authentication

Next steps