Jinn
Updated 2026-11-21
Jinn starts a new Linux VM for each call of a function. Each call is a run. When the run ends, Jinn returns its result.
A function defines the work of its runs:
- the disk that the VM boots;
- the commands that prepare the VM;
- the size of the VM;
- an AI agent, if you add one.
There are two types of function:
- A function with an agent. Each run receives a prompt and an input folder. The agent works until the files that you specify exist. Jinn then returns these files to you as one
.tar.gzfile. - A function without an agent. Each run is a VM that you control with commands. Commands run programs, read and write files, and copy files into and out of the VM. When the work is complete, you finish the run.
When a run ends, Jinn deletes the disk of the run. To keep the disk, set the function to save it as an image. The next run can boot that image. Your files and installed packages are then on the disk of the next run.
Jinn also provides persistent machines. A machine is backed by a lineage of images and has a fixed SSH address (<slug>@ssh.usejinn.com). It wakes automatically when you connect with SSH, stays running while connected, and saves its disk and stops after an idle timeout.
You can use Jinn from standard SSH, the CLI, the API, the SDKs or the console.
Start
If you are new to Jinn, do the Quickstart. It shows how to sign in, add a model key, publish a function and start a run. Or go straight to Machines to launch a persistent SSH dev VM.
Topics
- Examples: answer a support ticket, review a pull request, write a weekly report and examine a web page on a phone.
- Functions: the fields of a definition, setup commands, the agent, providers, custom tools and secrets.
- Runs: start and finish a run. States, failures, input, output and logs.
- Commands: run programs, read and write files, open a terminal and use your own agent.
- Machines: persistent SSH VMs that wake on connect and save their disk when idle.
- Images: save, boot and delete images. The cost of storage.
- Environment: the VM sizes, the installed software, the network limits and the data that Jinn keeps.
- Limits: all sizes, counts and durations in one table.
- API and webhooks.
- CLI and SDKs.
- Use Jinn from an agent: JSON output, exit codes and error codes.
For agents
Each page is also available in Markdown. Add .md to the address of the page, for example /runs.md. A request with Accept: text/markdown also receives Markdown. llms.txt lists all pages. llms-full.txt contains all pages in one file. openapi.json describes the API.