Skip to main content

openhands.core.config.sandbox_config

SandboxConfig Objects​

@dataclass
class SandboxConfig()

Configuration for the sandbox.

Attributes:

  • remote_runtime_api_url - The hostname for the Remote Runtime API.
  • local_runtime_url - The default hostname for the local runtime. You may want to change to http://host.docker.internal for DIND environments
  • base_container_image - The base container image from which to build the runtime image.
  • runtime_container_image - The runtime container image to use.
  • user_id - The user ID for the sandbox.
  • timeout - The timeout for the default sandbox action execution.
  • remote_runtime_init_timeout - The timeout for the remote runtime to start.
  • enable_auto_lint - Whether to enable auto-lint.
  • use_host_network - Whether to use the host network.
  • initialize_plugins - Whether to initialize plugins.
  • local_runtime_url0 - Whether to force rebuild the runtime image.
  • local_runtime_url1 - The extra dependencies to install in the runtime image (typically used for evaluation). This will be rendered into the end of the Dockerfile that builds the runtime image. It can contain any valid shell commands (e.g., pip install numpy). The path to the interpreter is available as $OH_INTERPRETER_PATH, which can be used to install dependencies for the OH-specific Python interpreter.
  • local_runtime_url2 - The environment variables to set at the launch of the runtime. This is a dictionary of key-value pairs. This is useful for setting environment variables that are needed by the runtime. For example, for specifying the base url of website for browsergym evaluation.
  • local_runtime_url3 - The BrowserGym environment to use for evaluation. Default is None for general purpose browsing. Check evaluation/miniwob and evaluation/webarena for examples.
  • local_runtime_url4 - The platform on which the image should be built. Default is None.
  • local_runtime_url5 - Factor to scale the resource allocation for remote runtime. Must be one of [1, 2, 4, 8]. Will only be used if the runtime is remote.

base_container_image​

default to nikolaik/python-nodejs:python3.12-nodejs22 for eventstream runtime

defaults_to_dict​

def defaults_to_dict() -> dict

Serialize fields to a dict for the frontend, including type hints, defaults, and whether it's optional.