Skip to main content
Download a file from the sandbox filesystem.

Basic Usage

from gravixlayer import GravixLayer

client = GravixLayer(api_key="YOUR_API_KEY")

sandbox = client.sandbox.sandboxes.create(template="python-base-v1", timeout=300)
sid = sandbox.sandbox_id

# Download a file (returns bytes)
data = client.sandbox.sandboxes.download_file(sid, path="/home/user/output.txt")
print(f"Downloaded: {len(data)} bytes")
print(data.decode("utf-8"))

Parameters

ParameterTypeRequiredDescription
sandbox_idstringYesSandbox ID
pathstringYesFile path to download

Example: Save Downloaded File Locally

# Download and save to local disk
data = client.sandbox.sandboxes.download_file(sid, path="/home/user/chart.png")
with open("chart.png", "wb") as f:
    f.write(data)
print("Saved chart.png locally")

Example: Download Generated Data

# Download CSV results
data = client.sandbox.sandboxes.download_file(sid, path="/home/user/results.csv")
with open("results.csv", "wb") as f:
    f.write(data)

File Types

Download any file type:
  • Generated reports: .pdf, .html
  • Data exports: .csv, .json, .xlsx
  • Visualizations: .png, .jpg, .svg
  • Code outputs: .py, .js, .txt
  • Archives: .zip, .tar.gz

Next Steps

List Files

Find files to download

Run Python Code

Generate files to download

Upload File

Upload files for processing

Terminate Sandbox

Clean up after downloading