Run a local workspace
Use this path to try the OSS workspace from a source checkout. You need Docker Compose, Go 1.26.10 or automatic toolchain download, and Python 3.10 or later. Node.js 24 is needed only if you rebuild the frontend packages.
Start the playground
Section titled “Start the playground”From the Beepgrid repository root:
python3 scripts/playground.pyOpen localhost:4010. Copy the value from .local/owner-token into the local login form. Keep that file private; it gives access to this local development workspace.
The bundled Scout and Builder are deterministic workers, so you can answer Scout’s question and send either agent a message without configuring a model.
Stop and resume
Section titled “Stop and resume”Ctrl+C stops the playground processes while preserving its PostgreSQL history. Start the command again to continue. Local email inspection is available at localhost:8125.
Connect your own worker
Section titled “Connect your own worker”Open Agents → Connect agent and follow the runtime instructions. The built-in worker examples do not host models; connect your own model handler when ready.
Before sharing it
Section titled “Before sharing it”The playground is a local development environment. Do not expose development mode, its owner token or a local mail viewer to the public internet. Use production setup before inviting real users.