Docs · Overview

GROTTE

EU-sovereign sandbox infrastructure for running AI-generated code in isolated cloud environments. Talk to it from JavaScript, TypeScript, or Python.

Install

JavaScript / TypeScript:

bash

npm install grotte

Python:

bash

pip install grotte

The CLI ships separately:

bash

npm install -g @grotte/cli

Get an API key

Sign up at app.grotte.parallactic.fr.
Issue a key from the Keys tab.
Set GROTTE_API_KEY in your environment:

bash

export GROTTE_API_KEY="grt_..."

Run your first sandbox

JavaScript:

import Sandbox from "grotte";
 
const sandbox = await Sandbox.create();
const result = await sandbox.commands.run("echo 'Hello from GROTTE!'");
console.log(result.stdout); // Hello from GROTTE!

Python:

from grotte import Sandbox
 
with Sandbox.create() as sandbox:
    result = sandbox.commands.run("echo 'Hello from GROTTE!'")
    print(result.stdout)  # Hello from GROTTE!

What's in the box

Sandboxes — isolated VMs with a filesystem, processes, and network egress you can toggle off. Pause to a snapshot, resume later.
Templates — start sandboxes from custom images. Build with grotte template create (guide) or via the dashboard.
Snapshots — freeze a sandbox's filesystem state into a reusable template.

Next steps

Defining a template — build a custom environment from a Dockerfile.
v1 → v2 migration — if you used the legacy grotte template build command, this is what changed.
Troubleshooting — fixes for the most common errors.
Support — where to get help.