Ling0925
/
suna
mirror of https://github.com/kortix-ai/suna.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
suna/backend/sandbox
History
marko-kraemer 0ae9b1cd10 wip 2025-05-18 06:23:01 +02:00
..
docker wip 2025-05-18 06:23:01 +02:00
README.md chore(docker): update Docker configurations and streamline browser handling 2025-05-18 05:49:09 +02:00
api.py refactor(api): streamline sandbox handling 2025-05-18 03:23:46 +02:00
sandbox.py chore(config): refactor sandbox image constants into common config 2025-05-17 23:09:03 +00:00
tool_base.py add ensure active, fix utils logger impot in sb tool base 2025-05-11 18:36:33 +02:00

README.md

Agent Sandbox

This directory contains the agent sandbox implementation - a Docker-based virtual environment that agents use as their own computer to execute tasks, access the web, and manipulate files.

Overview

The sandbox provides a complete containerized Linux environment with:

  • Chrome browser for web interactions
  • VNC server for accessing the Web User
  • Web server for serving content (port 8080) -> loading html files from the /workspace directory
  • Full file system access
  • Full sudo access

Customizing the Sandbox

You can modify the sandbox environment for development or to add new capabilities:

  1. Edit files in the docker/ directory
  2. Build a custom image: 
    cd backend/sandbox/docker
docker compose build
  3. Test your changes locally using docker-compose

Using a Custom Image

To use your custom sandbox image:

  1. Change the image parameter in docker-compose.yml (that defines the image name kortix/suna:___)
  2. Update the same image name in backend/sandbox/sandbox.py in the create_sandbox function
  3. If using Daytona for deployment, update the image reference there as well