README

 GOD · Govern · Observe · Direct



  


  🌩️ 像上帝一样，俯瞰一座由 Agent 组成的小镇。
  暂停时间。操控环境。对某个灵魂发问。一键重置 —— 全部在一个屏幕里完成。



  ▶ 浏览器回放
   ·  无需安装、无需 API key  · 
  本地运行



  🌐 浏览器回放 ·
  🚀 快速开始 ·
  更新 ·
  Roadmap ·
  亮点 ·
  核心能力 ·
  内置实验 ·
  公开站 ·
  AtomGit 镜像 ·
  开发者文档 ·
  参与开发 ·
  🌏 English



  
    
  



  
    
  
  
    
  
  
    
  
  
  
  
  
  
  


---

 大多数 agent-society demo 只能让你看着仿真自己跑完，GOD 把控制权交回到你手里。

 在同一个屏幕里回放一次运行、向任意居民提问、改变接下来发生的事，再导出一个别人能照着复现的包。
 它是用来检查 language-agent society 的，不负责声称它们有多接近真实社会。

 🗓️ 更新

- 2026-08-27 · 🎉🏆 GOD 被 EMNLP 2026 录用！ 论文已被 System Demonstrations track 录用。📄✨ 阅读 Camera-ready 论文。
- 2026-06-11 · v0.2.0： 公开站与浏览器回放；
  Experiment / Map / Agent 包 hub 与 ZIP 导入导出；Windows 一键启动；首次启动硬化。(64 65)
- 2026-06-06 · 公开站与资源包： 重做公开站与前端；站点资源包改走 release assets；地图包预览页。
  (61 62 63)
- 2026-06-01 · 可移植包： 统一 ExperimentPack 下载；GOD 包导入导出；精选实验库。(57 59 60)
- 2026-05-30 · Windows 启动器与 hub： god.cmd start 对齐 macOS/Linux 流程；AgentPack hub 与公开 replay 导出；JiuwenClaw 请求并行化。(45 49 50)
- 2026-05 · 操作台与 Studio： 双语控制台、地图优先 /ask + /intervene rail、
  Agent Studio、Map Studio、统一 skill runtime。(26 到 31)
- 2026-05-21 · v0.1.0： 首个打标发布，内置两个实验和 PKU 校园地图。(21 24)

 ✨ 亮点



  ⏯️暂停时间任意 step replay、暂停、加速、自动推进。
  💬定向提问在 live session 里向某个居民、群组或全镇发问。
  🎛️引导下一步注入指令，并检查 Agent 后续响应。
  🪄零代码上手浏览器配置向导：模型、剧本、Agent 一站搞定。
  🔄重置运行状态一条命令清掉旧数据，重新生成干净的小镇状态。



 🖼️ 截图


  


实时控制台：PKU 地图、step 控制、定向提问、居民列表全在一个界面里。

 🌐 浏览器回放

打开 公开站 在浏览器里逛一圈：精选回放、地图包、Agent 包和可下载实验。无需安装，也不用 API key。


  
    
  
   
  
    
  
   
  
    
  


从左到右：公开站首页、可下载地图包、可下载 Agent 包。

 🚀 快速开始

bash
git clone https://github.com/XiaoLuoLYG/GOD.git
cd GOD
./scripts/god.sh start


Windows PowerShell：进入仓库根目录后运行 .\scripts\god.cmd start。

首次启动会自动装好依赖，打开 浏览器中的实验配置向导，然后等你填完。你不用手改 .env，也不用记命令行参数。


  


实验配置向导：模型配置、默认实验选择、自建实验发布都在同一个浏览器流程里。



  🔌1. 模型填入 OpenAI 兼容的 API key、base URL 和模型名。
  🧭2. 选择打开 GOD Town、打开 PKU Trump Visit，或新建实验。
  🧪3. 剧本用自然语言描述世界：日期、天气、氛围、规则。
  🤖4. 生成GOD agent 自动起草 agent profile 和 step 计划。
  ✏️5. 编辑调整人物性格、关系、地点、步骤。
  ▶️6. 启动发布为当前实验，直接进入控制台。



任意 OpenAI 兼容接口都可以。向导收尾后，脚本会打印类似这样的地址：

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


完整步骤见 快速开始 →

 🧩 核心能力

|     | 能力 | 你得到什么 |
| --- | --- | --- |
| 🎬 | Replay 控制 | 按 step 拖动、暂停、跳转、自动推进，live 或已记录 replay 都行。 |
| 💬 | 定向提问 | 用自然语言向某个 Agent、某组人或全镇提问。 |
| 🎛️ | 实时干预 | 给即将执行的 step 注入指令，Agent 下一回合就读得到。 |
| ⌨️ | 命令输入器 | 在地图上直接输入 /ask 或 /intervene，用 @Name id 自动补全目标。 |
| 🪄 | 零代码配置向导 | 浏览器里配置模型 + 剧本，让 GOD 生成 Agent 和 step，编辑后启动。 |
| 🧬 | Agent Studio | 用地图感知的向导新增 / 编辑居民：seed、身份、外貌、性格、日程、review 一步步完成。 |
| 🧭 | 地图工作台 | 生成或上传地图草稿，校准地点与碰撞层，校验后发布为本地地图包。 |
| 🧼 | 一键重开 | 一条命令清掉 replay 数据，孵化一座干净的小镇。 |
| 🗺️ | 像素小镇世界 | 地点、动作、消息、状态都是结构化、replay 友好的。 |
| 🧱 | 唯一当前实验 | .env 只保存模型、API、端口等本机配置；.god/current_experiment.json 保存唯一 active 实验。 |
| 🌐 | 浏览器回放 | GitHub Pages 上的精选回放，无需本地安装或 API key。 |
| 📦 | 资源包库 | Experiment / Map / Agent 包导入导出；公开站还有更多可下载场景。 |
| 🪟 | Windows 启动器 | PowerShell 下 god.cmd start，与 macOS/Linux 同样一条命令。 |

 🛣️ Roadmap

 ✅ 已完成

- [x] 🗺️ 可拔插地图包：把