Guide
API
Blog
Version
Guide
API
Blog

Sandbox Info

Overview

The Sandbox API provides a comprehensive environment for executing code, managing files, and interacting with various development tools in an isolated container environment. This API is designed to support multiple programming languages, file operations, browser automation, and terminal interactions.

Dashboard

The Sandbox Dashboard provides a unified web interface accessible at /index.html for interacting with all sandbox features through multiple integrated views.

Dashboard Views

The dashboard interface includes four main tabs for different development workflows:

Code Tab

The Code tab provides an integrated code editor environment:

  • File Explorer: Navigate and manage project files in the sandbox
  • Code Editor: Edit files with syntax highlighting and auto-completion
  • Multi-file Support: Open and edit multiple files simultaneously
  • File Operations: Create, rename, delete files and directories
  • Integrated Terminal: Execute commands directly from the code view

Browser Tab

The Browser tab enables web development and testing:

  • Headless Browser: Chrome/Chromium instance for web automation
  • Live Preview: Real-time preview of web applications
  • Developer Tools: Inspect elements, console, network activity
  • Browser Automation: Support for automated testing and scraping
  • Viewport Control: Adjust screen size and device emulation
  • Screenshot Capture: Take screenshots of rendered pages

Terminal Tab

The Terminal tab provides full shell access:

  • Interactive Shell: Bash terminal with full command-line access
  • Multi-session Support: Create and manage multiple terminal sessions
  • Command History: Navigate through previously executed commands
  • File System Access: Full access to sandbox file system
  • Package Management: Install and manage Python/Node.js packages
  • Process Management: Run and monitor background processes

Jupyter Tab

The Jupyter tab offers notebook-based development:

  • Jupyter Notebooks: Create and edit .ipynb notebook files
  • Python Kernel: Execute Python code cells interactively
  • Rich Output: Display charts, images, and formatted data
  • Markdown Support: Mix code with documentation
  • Variable Explorer: Inspect variables and data structures
  • Session Persistence: Maintain kernel state across executions

Accessing the Dashboard

Local Access
Remote Access
# Dashboard is available at
http://localhost:8080/index.html

Dashboard Features

Integrated Development Environment

  • Seamless switching between Code, Browser, Terminal, and Jupyter views
  • Shared file system across all tabs
  • Persistent session state
  • Real-time updates and synchronization

Project Management

  • Upload files and projects via drag-and-drop
  • Download files and project archives
  • Git integration for version control
  • Project templates and quick starts

Resource Monitoring

  • CPU and memory usage indicators
  • Disk space utilization
  • Network activity monitoring
  • Process and service status

Sandbox Context

/llms.txt

llms.txt is an usage manual for Agents. Through this manual, the Agent can better use the sandbox.

Get Sandbox Context

Python
Curl
ctx = client.sandbox.get_context()
print(ctx)

Retrieves sandbox environment information including system configuration and available resources.

Response: SandboxResponse

  • success: Boolean indicating operation success
  • message: Operation result message
  • data: Sandbox environment data
  • home_dir: Home directory path in the sandbox

Example data:

System Environment (v1.0.0.93):
- Linux 6.10.14-linuxkit (x86_64), with internet access
- User: e3f8da5a6253, with sudo privileges
- Home directory: /home/gem
- Timezone: Asia/Shanghai
- Occupied Ports: 8080,8079,8088,8091,8100,8101,8102,8200,8888,9222

Development Environment:
- Python 3.12.11 (commands: python3, pip3)
- Node.js v22.19.0 (commands: node, npm)
- Git git version 2.34.1 (command: git)
- GitHub CLI (command: gh)
- UV uv 0.8.9 (command: uv)

Available Tools:
- Text editors: vim, nano
- File operations: wget, curl, tar, zip, unzip, tree
- Network tools: ping, telnet, netcat, nmap
- Text processing: grep, sed, awk, jq
- System monitoring: htop, procps
- Image processing: imagemagick
- Audio/Video Downloader: yt-dlp

Package Management

Python Packages

Lists all installed Python packages in the sandbox environment.

Python
Curl
python_packages = client.sandbox.python_packages()
print(python_packages.data) # [{ "name": "requests", "version": "2.32.5" }]

Response: Response

  • Returns a list of installed Python packages with their versions

Node.js Packages

Lists all installed Node.js packages in the sandbox environment.

Python
Curl
nodejs_packages = client.sandbox.nodejs_packages()
print(nodejs_packages.data)

Response: Response

  • Returns a list of installed npm packages with their versions