GOD Vibe 项目

项目简介

GOD 的全称是 Govern、Observe、Direct，中文可以理解为「治理、观察、指挥」，是一个本地优先的多智能体小镇模拟与实时操控平台。它把一整个城镇的 LLM 智能体放在同一张像素地图上持续运行，而你可以像上帝一样暂停时间、随时向任意居民提问、注入指令改写下一步行动，甚至一键重置世界。项目 GitHub 收获 1212 星，Apache-2.0 许可，论文已被 EMNLP 2026 System Demonstrations 收录。

核心功能

1. 时间操控：可随时暂停、拖动、快进、自动播放任意实时步骤，回放过程逐帧可控。
2. 定向提问：运行中途向单个居民、一组居民或全镇居民提问，直接观察其状态与回答。
3. 步骤干预：向智能体注入指令并检查其响应，用于研究提示注入、协作与行为演化。
4. 零代码配置：浏览器向导完成模型、场景与智能体配置，无需手改 .env 或命令行参数。
5. 可插拔内容：地图包、智能体包与实验包均可下载、导入导出，内置「普通工作日」「PKU 访问」等实验。

技术实现

GOD 采用清晰的四层架构并坚持本地优先。最上层是 Control Room，一套用 React 与 Vite 构建的浏览器界面，负责回放、提问、干预指令与状态展示；其下是本地 FastAPI 后端，对外暴露实时接口与回放接口，所有命令与状态更新都经由它中转；再下层是 Pixel Town，一个对回放友好的社交世界模型，维护地点、动作、消息与智能体状态，并把每一步动作写入以 SQLite 实现的 Replay Store；最底层是 Agent Runtime，智能体运行在独立进程中，通过本地 WebSocket 与后端通信，模型端点是整个系统唯一允许的外部服务。系统刻意把三个概念分开：Experiment 是可玩的配置（地图、智能体、场景上下文、步进计划），Replay 是实验跑完后的可观看结果，Runtime state 则是本地机器数据（SQLite 回放库、日志、智能体快照），不属于实验包也不应提交进版本库。这种设计让一次实验既能完整归档分享，又能被反复重放与逐步审阅。前端、后端、运行时桥接、实验文件与回放存储全部跑在用户机器上，真正做到数据不出门；首次运行脚本会自动完成安装并打开配置向导，Windows 下用 god.cmd 与 macOS/Linux 保持一致的启动流程。

快速上手

1. 克隆仓库并启动：git clone https://github.com/XiaoLuoLYG/GOD.git && cd GOD && ./scripts/god.sh start（Windows 使用 .scriptsgod.cmd start）。
2. 首次运行会自动安装依赖并打开浏览器配置向导，在其中选择模型、场景与智能体配置。
3. 进入控制室：通过 ./scripts/god.sh status 查看端口与地址，打开 Control Room 观察小镇实时运行。
4. 操作与重放：使用暂停/快进控制时间，向居民提问或注入指令；结束后用 ./scripts/god.sh new-run 重置世界，或在公开站点浏览已有的浏览器回放。

适用人群

多智能体系统与生成式智能体研究者、LLM 应用开发者、做提示注入与协作实验的工程师，以及希望用可视化方式讲解智能体社会行为的教师与内容创作者。

官方链接

https://github.com/XiaoLuoLYG/GOD （公开站点：https://xiaoluolyg.github.io/GOD/）