Code sandbox

pip install together-sandbox

npm install together-sandbox

curl -fsSL https://raw.githubusercontent.com/togethercomputer/together-sandbox/main/install.sh | bash

import asyncio

from together_sandbox import CreateImageSnapshotParams, TogetherSandbox


async def main():
    async with TogetherSandbox() as sdk:
        result = await sdk.snapshots.create(
            CreateImageSnapshotParams(
                image="python:3.12-slim",
                alias="my-python@v1",
            )
        )
        print(result.snapshot_id)


asyncio.run(main())

import { TogetherSandbox } from "together-sandbox";

const sdk = new TogetherSandbox({ apiKey: process.env.TOGETHER_API_KEY! });

const result = await sdk.snapshots.create({
  image: "python:3.12-slim",
  alias: "my-python@v1",
});

console.log(result.snapshotId);

together-sandbox snapshots create --image python:3.12-slim --alias my-python@v1

import asyncio

from together_sandbox import TogetherSandbox


async def main():
    sdk = TogetherSandbox()
    sandbox = await sdk.sandboxes.create(snapshot_alias="my-python@v1")

    result = await sandbox.execs.exec("python3", ["-c", "print(6 * 7)"])
    print(result["exit_code"], result["output"])

    await sandbox.files.create("/tmp/data.txt", "Hello, sandbox!")
    print(await sandbox.files.read("/tmp/data.txt"))

    await sandbox.terminate()


asyncio.run(main())

import { TogetherSandbox } from "together-sandbox";

const sdk = new TogetherSandbox({ apiKey: process.env.TOGETHER_API_KEY! });
const sandbox = await sdk.sandboxes.create({ snapshotAlias: "my-python@v1" });

const result = await sandbox.execs.exec("python3", ["-c", "print(6 * 7)"]);
console.log(result.exitCode, result.output);

await sandbox.files.create("/tmp/data.txt", "Hello, sandbox!");
console.log(await sandbox.files.read("/tmp/data.txt"));

await sandbox.terminate();

# Run one command in a throwaway sandbox
together-sandbox sandboxes run @my-python@v1 --rm -- python3 -c "print(6 * 7)"

# Or keep a sandbox and run commands in it repeatedly
SANDBOX_ID=$(together-sandbox sandboxes create @my-python@v1 | awk '{print $3}')
together-sandbox sandbox exec run "$SANDBOX_ID" -- python3 -c "print(6 * 7)"
together-sandbox sandbox exec run "$SANDBOX_ID" -it -- bash
together-sandbox sandboxes terminate "$SANDBOX_ID"