Full Example

FROM python:3.12-alpine

RUN apk add --no-cache bash curl gawk \
    && curl -sL https://git.io/trans -o /usr/local/bin/trans \
    && chmod +x /usr/local/bin/trans

COPY skills/ /skills/
WORKDIR /workspace

CMD ["sh", "-c", "while true; do if [ -f /shutdown/terminate ]; then exit 0; fi; sleep 1; done"]

export CLIENT_ID="your-client-id"
export CLIENT_SECRET="your-client-secret"
export IMAGE=registry.trelent.com/$CLIENT_ID/translator:latest

echo "$CLIENT_SECRET" | docker login registry.trelent.com -u "$CLIENT_ID" --password-stdin
docker build -t $IMAGE .
docker push $IMAGE

from trelent_agents import (
    Client,
    ClaudeCodeHarnessSpec,
    LocalImporter,
    S3Exporter,
)

client = Client(
    client_id="your-client-id",
    client_secret="your-client-secret",
)

run = client.runs.create(
    sandbox="translator:latest",
    harness=ClaudeCodeHarnessSpec(model="claude-sonnet-4-6"),
    prompt="""
Read /skills/translate.md to learn your tools.
Translate all files in /mnt/ to Spanish.
Save translations to /output/.
""",
    imports=[
        LocalImporter(path="./input"),
    ],
    exports=[
        S3Exporter(),
    ],
)

while run.status not in ("completed", "failed", "cancelled"):
    run.refresh()

print("Spanish translations:", run.result.output)

# Fork to translate the same files to French
french_run = run.fork(
    prompt="Now translate the same files to French.",
    imports=[
        LocalImporter(path="./input"),
    ],
    exports=[
        S3Exporter(),
    ],
)

while french_run.status not in ("completed", "failed", "cancelled"):
    french_run.refresh()

print("French translations:", french_run.result.output)