Skip to main content
An instance is your persistent sandbox: a Linux computer for code, services, or agent harnesses. Get an API key, then run export AGENT37_API_KEY="sk_live_..." in your terminal. Your workspace wallet funds compute.

Create and run

The curl example uses jq; Python uses requests; Node uses built-in fetch. Run these calls from your backend or terminal.
Result
The instance keeps its files between commands. exec runs as the image’s default user; read exit_code to tell whether your command succeeded. See Run commands for root access, timeouts, and background processes. The default template is agent37-hermes, which includes Linux tools and the Hermes agent. This quickstart uses its shell. Choose another template or bring your own Docker image for your workload; an Agent API is a capability of the image you choose.

Reach a service on any port

A service listening on port 8000 is reachable at https://{instanceId}-8000.agent37.app. No port registration is needed. Start this example server on the instance you just created, then request its preview URL:
If the server is still starting, retry the preview request. To open the service in a browser, create a signed URL. Use a public port when a caller cannot send credentials.
The Hosting API uses Authorization: Bearer. Instance and preview URLs use X-Agent37-Key, leaving Authorization available to the software you run. Keep your workspace key on your backend.

Clean up

Delete the instance when you are done. This removes its data and ends billing. To keep its files, stop it instead; stopped instances still bill for disk.

Build on your sandbox

Bring your own image

Run your own tools, services, or agent harness.

Instance lifecycle

Stop, restart, resize, and update while keeping your data.

Use an agent template

Create a Hermes instance and send its first message.

Examples

Host harnesses, build apps, and connect external agents.
For coding agents, start with the documentation index to retrieve individual pages, or use the complete reference.