XiaoLuoLYG /GOD
Govern, Observe, Direct - a real-time control room for agent societies
★ 1,261⑂ 136👁 32▤ 2
+0
Daily
+0
Weekly
+39
Monthly
1,261
stars
136
forks
32
watchers
–
prs
–
issues
2
releases
README
GOD · Govern · Observe · Direct
🌩️ Be like a god to a town of agents.
Pause time. Whisper to a soul. Bend the next step. Reset the world — all from a single click.
▶ Try browser replay
· no install, no API key ·
Run locally
🌐 Live Demo ·
🚀 Quick Start ·
Updates ·
Roadmap ·
Highlights ·
Features ·
Built-in Experiments ·
Public Site ·
AtomGit Mirror ·
Developer Docs ·
Contributing ·
🌏 中文
---
Most agent-society demos let you watch a simulation play out. GOD gives you the controls.
Replay a run, question any resident, change what happens next, and export a pack others can rerun, all from one screen.
It is built for inspecting language-agent societies, not for claiming they are socially realistic.
🗓️ Updates
- 2026-08-27 · 🎉🏆 GOD accepted at EMNLP 2026! Our paper was accepted to the System Demonstrations track. 📄✨ Read the camera-ready paper.
- 2026-06-11 · v0.2.0: public site with browser replays;
Experiment / Map / Agent pack hubs and ZIP import-export; Windows launcher; hardened first-run startup.
(64 65)
- 2026-06-06 · Site & packs: rebuilt public site and frontend; site packs delivered through release assets; map pack preview pages. (61 62 63)
- 2026-06-01 · Portable packs: unified ExperimentPack downloads; GOD package import/export; curated experiment library.
(57 59 60)
- 2026-05-30 · Windows launcher & hubs: god.cmd start matches the macOS/Linux flow; AgentPack hubs and public replay exports; parallel JiuwenClaw requests. (45 49 50)
- 2026-05 · Operator studios: bilingual control room, map-first /ask + /intervene rail,
Agent Studio, Map Studio, unified skill runtime.(26 to 31)
- 2026-05-21 · v0.1.0: first tagged release with two built-in experiments and the PKU campus map. (21 24)
✨ Highlights
⏯️Pause timeStop, scrub, fast-forward, auto-play any live step.
💬Ask anyoneAsk one resident, a group, or the whole town, mid-run.
🎛️Steer the next stepInject instructions and inspect how agents respond.
🪄No-code setupConfigure model, scenario and agents from a browser wizard.
🔄Reset run stateOne command wipes a stale run and re-seeds a clean world.
🖼️ Screenshots
Live control room: PKU map, step controls, targeted ask, and resident roster in one view.
🌐 Live Demo
Browse everything in your browser on the public site: curated replays, map packs, agent packs, and downloadable experiments. No install or API key needed.
Left to right: the public site homepage, downloadable map packs, and downloadable agent packs.
🚀 Quick Start
bash
git clone https://github.com/XiaoLuoLYG/GOD.git
cd GOD
./scripts/god.sh start
Windows PowerShell: from the repo root, run .\scripts\god.cmd start.
On the first run the script installs everything, opens a browser-based setup wizard, and waits for you to finish. You never have to edit