Skip to main content
Execute shell commands, install packages, and run system utilities in your sandbox.
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

# List files
result = client.sandbox.sandboxes.run_command(sid, command="ls", args=["-la", "/home/user"])
print(result.stdout)

# Install packages
result = client.sandbox.sandboxes.run_command(sid, command="pip", args=["install", "pandas"])
print(f"Exit code: {result.exit_code}")

# Check Python version
result = client.sandbox.sandboxes.run_command(sid, command="python", args=["--version"])
print(result.stdout.strip())

client.sandbox.sandboxes.kill(sid)

Request Parameters

ParameterTypeRequiredDescription
commandstringYesCommand to execute
argsarrayNoCommand arguments
timeoutintegerNoTimeout in milliseconds (default: 30000)

Response

{
  "stdout": "total 16\ndrwxr-xr-x 2 user user 4096 Jan 27 10:35 .\ndrwxr-xr-x 3 root root 4096 Jan 27 10:30 ..\n-rw-r--r-- 1 user user   95 Jan 27 10:35 config.json",
  "stderr": "",
  "exit_code": 0,
  "duration_ms": 45,
  "success": true
}

Common Commands

Install Python Packages

result = client.sandbox.sandboxes.run_command(
    sid,
    command="pip",
    args=["install", "streamlit", "plotly"],
)
print(f"Exit code: {result.exit_code}")

Install Node.js Packages

result = client.sandbox.sandboxes.run_command(
    sid,
    command="npm",
    args=["install", "puppeteer", "sharp"],
)
print(f"Exit code: {result.exit_code}")

System Information

result = client.sandbox.sandboxes.run_command(sid, command="uname", args=["-a"])
print(result.stdout)

Error Handling

Command Not Found (exit code 127):
{
  "stdout": "",
  "stderr": "bash: nonexistent: command not found",
  "exit_code": 127,
  "duration_ms": 12,
  "success": false
}

Next Steps

Run Python Code

Execute Python code with installed packages

Run JavaScript Code

Execute Node.js code with installed packages

Read Files

Read files created by commands

Templates

Learn about pre-installed packages