Skip to main content
A sandbox is a Docker image that defines your agent’s environment. The agent has built-in tools: read_file, write_file, and bash. Any programs you add to the sandbox become tools the agent can invoke.

​
Structure

A typical sandbox includes:
  • /skills/ — Markdown files describing what the agent can do
  • CLI tools installed via the Dockerfile
FROM python:3.12-slim

RUN apt-get update \
    && apt-get install -y translate-shell

COPY skills/ /skills/

CMD ["sh", "-c", "while true; do \
    if [ -f /shutdown/terminate ]; then exit 0; fi; \
    sleep 1; \
done"]
The agent reads /skills/ to learn what it can do, then runs tools via bash.

​
Build and push

export IMAGE=agents.trelent.com/translator:latest

docker build -t $IMAGE .
docker push $IMAGE

​
List sandboxes

from trelent_agents import Client

client = Client()

sandboxes = client.sandboxes.list()
print(sandboxes)