Quickstart

Start GOD

./scripts/god.sh start

start is idempotent: if a service is already running, the script reuses it where possible.

First-run flow

On a clean checkout, GOD will:

  1. Create .env from .env.example.

  2. Install Python and Node dependencies.

  3. Start the setup backend and control room.

  4. Open the browser setup wizard at /setup.

  5. Ask for an OpenAI-compatible API key, base URL, and model name.

  6. Let you choose GOD Town, PKU Trump Visit, or create a custom experiment.

  7. Start the full stack for the selected current experiment.

  8. Create a live session, prime the first step, and open PixelReplay.

Expected control room URL

For the default GOD Town experiment, the URL looks like:

http://127.0.0.1:5174/pixel-replay/god_town/1

For PKU Trump Visit:

GOD_EXPERIMENT=pku_trump_visit GOD_EXPERIMENT_RUN=1 ./scripts/god.sh new-run

Then open:

http://127.0.0.1:5174/pixel-replay/pku_trump_visit/1

Verify

./scripts/god.sh status

Healthy output should show backend, control room, agent runtime, runtime web, runtime gateway, and runtime UI ports as up.

When to use new-run

Use restart for process cleanup without wiping the current replay. Use new-run when you want a fresh live session and clean replay state for the current experiment.