---
title: "Quickstart"
description: "Create a sandbox, write a file and run a process."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.jgcp.mistrivedev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

Create a sandbox, write a file to it, run a process that reads the file, and delete the sandbox.

1. **Get an API key and a project.**

   You need an API key and the id of the project your sandboxes belong to. See [Projects and API keys](https://docs.jgcp.mistrivedev.com/projects-and-api-keys/).

2. **Set your environment.**

   The TypeScript and Python samples read both values from the environment.

   ```bash
   export SUTRA_API_KEY="your-api-key"
   export SUTRA_PROJECT="<project-id>"
   ```

3. **Install the SDK or the CLI.**

   ### TypeScript

   ```bash
   npm install @mistrive/anchor
   ```

   ### Python

   ```bash
   pip install mistrive-anchor
   ```

   ### CLI

   Ask your Sutra contact for the `anchor` CLI build. Then log in once. The CLI saves the API URL, key and project in a profile.

   ```bash
   echo "$SUTRA_API_KEY" | anchor auth login --token-stdin --project "$SUTRA_PROJECT" \
     --api-url "https://anchor.jgcp.mistrivedev.com"
   ```

4. **Create a sandbox and run a process.**

5. **Check what happened.**

   Sutra created a sandbox and gave it an id. The sample wrote `hello.txt` to it and ran `cat` in a process, which printed `hello world`. Then it deleted the sandbox.

   The sandbox opened no port, so nothing in it was reachable from outside. A sandbox runs until you stop or delete it, unless you give it a time limit. See [Sandboxes](https://docs.jgcp.mistrivedev.com/sandboxes/).

:::note[Today]
The Today samples use `@mistrive/anchor`, `mistrive-anchor` and the `anchor` CLI. The Sutra SDK replaces them: `@mistrive/sutra`, `mistrive-sutra` and the `sutra` CLI, which you log in to with `sutra auth login`. The Target samples show its shape. Use the switch above any sample to compare.
:::

## Next steps

- [Processes](https://docs.jgcp.mistrivedev.com/sandboxes/processes/) — Run commands and long-lived processes.
- [Ports](https://docs.jgcp.mistrivedev.com/sandboxes/ports/) — Open a port to reach a server in a sandbox.
- [OpenCode](https://docs.jgcp.mistrivedev.com/examples/opencode/) — Run the OpenCode agent in a sandbox.

Source: https://docs.jgcp.mistrivedev.com/quickstart/index.mdx
