Overview

A sandbox is the environment where Faheem Code runs commands, edits files, and starts servers while working on your task.

In Faheem Code V1, we use the term sandbox (not “runtime”) for this concept.

Sandbox providers

Faheem Code supports multiple sandbox “providers”, with different tradeoffs:

• Docker sandbox (recommended)

  • Runs the agent server inside a Docker container.
  • Good isolation from your host machine.

• Process sandbox (unsafe, but fast)

  • Runs the agent server as a regular process on your machine.
  • No container isolation.

• Remote sandbox

  • Runs the agent server in a remote environment.
  • Used by managed deployments and some hosted setups.

Selecting a provider (current behavior)

In some deployments, the provider selection is still controlled via the legacy RUNTIME environment variable:

• RUNTIME=docker (default)
• RUNTIME=process (aka legacy RUNTIME=local)
• RUNTIME=remote

Note

The user-facing terminology in V1 is sandbox, but the configuration knob may still be called RUNTIME while the migration is in progress.

Terminology note (V0 vs V1)

Older documentation refers to these environments as runtimes. Those legacy docs are now in the Legacy (V0) section of the Web tab.