XiaoLuoLYG /GOD

Govern, Observe, Direct - a real-time control room for agent societies

★ 1,261⑂ 136👁 32▤ 2
PythonCreated 2026-05-11xiaoluolyg.github.io/GOD/
+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

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON