Imports & Exports - Trelent Docs

Imports bring data into the run environment at /mnt/. Exports persist outputs after the run completes.

Imports

from trelent_agents import Client, LocalImporter

client = Client(client_id="...", client_secret="...")

run = client.runs.create(
    sandbox="translator:latest",
    prompt="Translate all files in /mnt/ to Spanish.",
    imports=[
        LocalImporter(path="./documents"),
    ],
)

The directory is tarballed, uploaded, and extracted to /mnt/ inside the sandbox. See LocalImporter.

Exports

from trelent_agents import Client, S3Exporter

client = Client(client_id="...", client_secret="...")

run = client.runs.create(
    sandbox="translator:latest",
    prompt="Translate files to Spanish. Save to /output/.",
    exports=[
        S3Exporter(),
    ],
)

S3Exporter captures the run’s workspace snapshot on completion and drops it into the default output bucket. To target a specific bucket or prefix:

S3Exporter(bucket="my-bucket", path="translations/run-1/")