grotte 0.1.0

GROTTE SDK that give agents cloud environments

What is GROTTE?

GROTTE is an open-source infrastructure that allows you to run AI-generated code in secure isolated sandboxes in the cloud. To start and control sandboxes, use our JavaScript SDK or Python SDK.

Run your first Sandbox

1. Install SDK

pip install grotte

2. Get your GROTTE API key

1. Sign up to GROTTE here.
2. Get your API key here.
3. Set environment variable with your API key

GROTTE_API_KEY=grt_***

3. Start a sandbox and run commands

from grotte import Sandbox

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

4. Code execution with Code Interpreter

If you need run_code(), install the Code Interpreter SDK:

pip install grotte-code-interpreter

from grt_code_interpreter import Sandbox

with Sandbox.create() as sandbox:
    execution = sandbox.run_code("x = 1; x += 1; x")
    print(execution.text)  # outputs 2

5. Check docs

Visit GROTTE documentation.

6. GROTTE cookbook

Visit our Cookbook to get inspired by examples with different LLMs and AI frameworks.