[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77974":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":38,"readmeContent":39,"aiSummary":40,"trendingCount":16,"starSnapshotCount":16,"syncStatus":41,"lastSyncTime":42,"discoverSource":43},77974,"GOD","XiaoLuoLYG\u002FGOD","XiaoLuoLYG","Govern, Observe, Direct - a real-time control room for agent societies","",null,"Python",617,90,32,12,0,10,51,487,39,9.88,"Apache License 2.0",false,"main",[26,27,28,29,30,31,32,33,34,35,36,37],"agent","agent-control-room","agent-society","generative-agents","human-in-the-loop","llm-agents","multi-agent-simulation","openai-compatible","pixel-replay","python","react","social-simulation","2026-06-12 02:03:45","\u003Ch1 align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Flogo_no_bg.png\" alt=\"GOD logo\" height=\"32\" \u002F>\n   GOD · Govern · Observe · Direct\n\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fscreenshots\u002F00-hero.png\" alt=\"GOD — Govern · Observe · Direct\" width=\"100%\" \u002F>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Cb>🌩️ Be like a god to a town of agents.\u003C\u002Fb>\u003Cbr\u002F>\n  Pause time. Whisper to a soul. Bend the next step. Reset the world — all from a single click.\n\u003C\u002Fp>\n\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#-quick-start\">\u003Cb>🚀 Quick Start\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\"#-highlights\">Highlights\u003C\u002Fa> ·\n  \u003Ca href=\"#-features\">Features\u003C\u002Fa> ·\n  \u003Ca href=\"#%EF%B8%8F-how-it-works\">How it works\u003C\u002Fa> ·\n  \u003Ca href=\"#-built-in-experiments\">Built-in Experiments\u003C\u002Fa> ·\n  \u003Ca href=\"#%EF%B8%8F-roadmap\">Roadmap\u003C\u002Fa> ·\n  \u003Ca href=\"CONTRIBUTING.md\">Contributing\u003C\u002Fa> ·\n  \u003Ca href=\"README.zh-CN.md\">🌏 中文\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg alt=\"Python\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white\" \u002F>\n  \u003Cimg alt=\"React\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReact-18-61DAFB?style=flat-square&logo=react&logoColor=black\" \u002F>\n  \u003Cimg alt=\"Vite\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVite-6-646CFF?style=flat-square&logo=vite&logoColor=white\" \u002F>\n  \u003Cimg alt=\"No-Code Setup\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fsetup-no--code-22c55e?style=flat-square&logo=googlechrome&logoColor=white\" \u002F>\n  \u003Cimg alt=\"License\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache--2.0-blue?style=flat-square\" \u002F>\n  \u003Cimg alt=\"PRs welcome\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-14b8a6?style=flat-square\" \u002F>\n  \u003Cimg alt=\"Status\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fstatus-alpha-orange?style=flat-square\" \u002F>\n\u003C\u002Fp>\n\n---\n\n> Other generative-agent projects let you **watch**.\n> **GOD lets you reign.**\n>\n> One screen. Pause time. Question any soul. Rewrite the next step. Restart the world.\n> The missing operator console for a society of agents — alive while you steer it.\n\n## ✨ Highlights\n\n\u003Ctable>\n\u003Ctr>\n  \u003Ctd align=\"center\" width=\"20%\">⏯️\u003Cbr\u002F>\u003Cb>Pause time\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Stop, scrub, fast-forward, auto-play any live step.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">💬\u003Cbr\u002F>\u003Cb>Whisper to anyone\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Ask one resident, a group, or the whole town — mid-run.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🎛️\u003Cbr\u002F>\u003Cb>Bend the next step\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Inject instructions and watch agents react in real time.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🪄\u003Cbr\u002F>\u003Cb>No-code setup\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Configure model, scenario and agents from a browser wizard.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🔄\u003Cbr\u002F>\u003Cb>Reset reality\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>One command wipes a stale run and re-seeds a clean world.\u003C\u002Fsub>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## 🖼️ Screenshots\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fscreenshots\u002F01-control-room.png\" alt=\"GOD control room\" width=\"94%\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Csub>Live control room — PKU map, step controls, targeted ask, and resident roster in one view.\u003C\u002Fsub>\u003C\u002Fp>\n\n## 🚀 Quick Start\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FXiaoLuoLYG\u002FGOD.git\ncd GOD\n.\u002Fscripts\u002Fgod.sh start\n```\n\nThat's it. On first run, the script installs everything, opens a **browser-based setup wizard**, and waits for you. No `.env` editing, no command-line flags, no glue scripts.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fscreenshots\u002F02-setup-wizard-en.png\" alt=\"GOD setup wizard\" width=\"100%\" \u002F>\n\u003C\u002Fp>\n\n\n\u003Cp align=\"center\">\u003Csub>The Setup Wizard — model config, experiment choice, and custom society creation from one browser flow.\u003C\u002Fsub>\u003C\u002Fp>\n\n\u003Ctable>\n\u003Ctr>\n  \u003Ctd align=\"center\" width=\"16%\">🔌\u003Cbr\u002F>\u003Cb>1. Model\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Paste an OpenAI-compatible API key, base URL, and model name.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"16%\">🧭\u003Cbr\u002F>\u003Cb>2. Choose\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Open GOD Town, open PKU Trump Visit, or create your own.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"16%\">🧪\u003Cbr\u002F>\u003Cb>3. Scenario\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Describe your world — date, weather, vibes, rules.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"16%\">🤖\u003Cbr\u002F>\u003Cb>4. Generate\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>The GOD agent drafts agent profiles and a step plan.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"16%\">✏️\u003Cbr\u002F>\u003Cb>5. Edit\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Tweak personalities, relationships, locations, or steps.\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"16%\">▶️\u003Cbr\u002F>\u003Cb>6. Launch\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>Publish the experiment and step into the control room.\u003C\u002Fsub>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\nAny OpenAI-compatible endpoint works. When the wizard hands off, the script prints a URL like:\n\n```text\nhttp:\u002F\u002F127.0.0.1:5174\u002Fpixel-replay\u002Fgod_town\u002F1\n```\n\nFull walkthrough: **[Quickstart →](QUICKSTART.md)**\n\n## 🧩 Features\n\n|     | Feature | What you get |\n| --- | --- | --- |\n| 🎬 | **Replay control** | Scrub a live or recorded run by step. Pause, jump, auto-play. |\n| 💬 | **Targeted ask** | Send a natural-language question to one agent, a group, or the whole town. |\n| 🎛️ | **Real-time intervention** | Inject instructions into the *next* step — the agents read them on their next turn. |\n| 🪄 | **No-code setup wizard** | Browser-based: configure model + scenario, let GOD generate agents and steps, edit, then launch. |\n| 🧼 | **One-command reset** | Wipe replay data and seed a clean society without leaving the terminal. |\n| 🗺️ | **Pixel town world** | A live tiled map: locations, actions, messages, statuses — every step replay-friendly. |\n| 🧱 | **Single current experiment** | `.env` stores local model\u002Fport settings; `.god\u002Fcurrent_experiment.json` stores the one active experiment. |\n\n## 🏗️ How It Works\n\n```mermaid\nflowchart LR\n  O[\"Operator\"]:::operator\n  UI[\"Control Room\"]:::surface\n  API[\"Live API\"]:::core\n  RT[\"Agent Runtime\"]:::runtime\n  TOWN[\"Pixel Town\"]:::world\n  CFG[[\"Experiment Files\"]]:::data\n  DB[(\"Replay Store\")]:::data\n\n  O --> UI\n  UI \u003C-->|\"commands \u002F updates\"| API\n  API -->|\"prompts\"| RT\n  RT -->|\"actions\"| TOWN\n  TOWN -->|\"frames\"| DB\n  CFG -->|\"scenario\"| API\n\n  classDef operator fill:#fff7ed,stroke:#f59e0b,color:#7c2d12,stroke-width:2px;\n  classDef surface fill:#eef2ff,stroke:#6366f1,color:#312e81,stroke-width:2px;\n  classDef core fill:#ecfeff,stroke:#0891b2,color:#164e63,stroke-width:2px;\n  classDef runtime fill:#f0fdf4,stroke:#22c55e,color:#14532d,stroke-width:2px;\n  classDef world fill:#fefce8,stroke:#ca8a04,color:#713f12,stroke-width:2px;\n  classDef data fill:#fdf2f8,stroke:#db2777,color:#831843,stroke-width:2px;\n```\n\nGOD is intentionally local-first: the control room, backend, runtime bridge, experiment files, and replay store all run on your machine. The model endpoint is the only external service you choose.\n\n| Layer | What it does |\n| --- | --- |\n| 🎮 **Control Room** | React\u002FVite browser UI — replay, ask, intervention, status. |\n| ⚙️ **Backend** | Local FastAPI service exposing live and replay APIs. |\n| 🗺️ **Pixel Town** | Replay-friendly social world: locations, actions, messages, agent status. |\n| 🤖 **Agent Runtime** | Out-of-process LLM agents reached over a local WebSocket. |\n\n## ⚙️ Commands\n\n```bash\n.\u002Fscripts\u002Fgod.sh start      # start the full stack (idempotent)\n.\u002Fscripts\u002Fgod.sh configure  # open setup to switch defaults or create an experiment\n.\u002Fscripts\u002Fgod.sh restart    # stop everything cleanly, then start again\n.\u002Fscripts\u002Fgod.sh new-run    # wipe the current experiment run and start fresh\n.\u002Fscripts\u002Fgod.sh status     # ports, URLs, model status\n.\u002Fscripts\u002Fgod.sh stop       # stop everything\n.\u002Fscripts\u002Fgod.sh tail       # follow logs\n.\u002Fscripts\u002Fgod.sh open       # open the frontend pages in the default browser\n```\n\n## 🧪 Built-in Experiments\n\nGOD ships two built-in experiments and treats them exactly like experiments you publish yourself. The setup wizard writes the selected experiment to `.god\u002Fcurrent_experiment.json`; `start`, `open`, and `new-run` then act only on that current experiment.\n\n`.env` is intentionally local-only and only stores model, API, port, and similar machine settings. It no longer decides the default experiment or map, so an old `GOD_MAP_ID=pku` cannot make GOD Town load the PKU map.\n\n\n### 🏘️ An ordinary weekday in The Ville\n\nA late-spring Tuesday morning at 8:20. Sunny, 18°C, light breeze. A 200-person town with **10 residents who know each other but don't live in each other's pockets** — a slice-of-life simulation, not a quest script.\n\n➡️ **Choose `god_town` in the Setup Wizard to make this the current experiment.** It is bound to `hypothesis_god_town\u002Fexperiment_1` and the `the_ville` map.\n\n➡️ See [`hypothesis_god_town\u002Fexperiment_1\u002F`](agentsociety\u002Fquick_experiments\u002Fhypothesis_god_town\u002Fexperiment_1\u002FREADME.md) for the full breakdown of locations, profiles, and interactions.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fscreenshots\u002Fmap-the-ville.png\" alt=\"The Ville map\" width=\"94%\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Csub>The Ville — all 10 residents going about a typical day across home, school, library, cafe, park, market, pharmacy, pub, and dorm.\u003C\u002Fsub>\u003C\u002Fp>\n\n\u003Ctable>\n\u003Ctr>\u003Ctd colspan=\"5\" align=\"center\">\u003Cb>🗺️ 10 Locations · 65 location-scoped interactions\u003C\u002Fb>\u003C\u002Ftd>\u003C\u002Ftr>\n\u003Ctr>\n  \u003Ctd align=\"center\" width=\"20%\">🏠\u003Cbr\u002F>\u003Cb>Home\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>cook · sleep · tidy · read · WFH · video-call\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🏫\u003Cbr\u002F>\u003Cb>School\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>attend \u002F teach class · grade · office hours\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">📚\u003Cbr\u002F>\u003Cb>Library\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>read · study · research · borrow \u002F return\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">☕\u003Cbr\u002F>\u003Cb>Hobbs Cafe\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>light meal · coffee chat · cafe shift · meetup\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🌳\u003Cbr\u002F>\u003Cb>Johnson Park\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>walk · meet · exercise · public announcement\u003C\u002Fsub>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n  \u003Ctd align=\"center\" width=\"20%\">🛠️\u003Cbr\u002F>\u003Cb>Supply Store\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>repair · restock · lend tools · customer service\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🛒\u003Cbr\u002F>\u003Cb>Market\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>buy food · haggle · deliver · chat w\u002F regulars\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">💊\u003Cbr\u002F>\u003Cb>Pharmacy\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>buy medicine · refill · check BP · home visit prep\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🍻\u003Cbr\u002F>\u003Cb>Pub\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>socialize · watch match · host small event\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🛏️\u003Cbr\u002F>\u003Cb>Dorm\u003C\u002Fb>\u003Cbr\u002F>\u003Csub>rest · self-study · common-room hangout · video call\u003C\u002Fsub>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Ctable>\n\u003Ctr>\u003Ctd colspan=\"5\" align=\"center\">\u003Cb>👥 10 residents — each with a real life\u003C\u002Fb>\u003C\u002Ftd>\u003C\u002Ftr>\n\u003Ctr>\n  \u003Ctd align=\"center\" width=\"20%\">🧭\u003Cbr\u002F>\u003Cb>Alice\u003C\u002Fb> · 34\u003Cbr\u002F>\u003Csub>Neighborhood coordinator\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🛠️\u003Cbr\u002F>\u003Cb>Bob\u003C\u002Fb> · 45\u003Cbr\u002F>\u003Csub>Supply-store shopkeeper\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">📖\u003Cbr\u002F>\u003Cb>Charlie\u003C\u002Fb> · 39\u003Cbr\u002F>\u003Csub>High-school history teacher\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">💊\u003Cbr\u002F>\u003Cb>Dana\u003C\u002Fb> · 41\u003Cbr\u002F>\u003Csub>Pharmacy nurse\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">☕\u003Cbr\u002F>\u003Cb>Elena\u003C\u002Fb> · 36\u003Cbr\u002F>\u003Csub>Cafe owner\u003C\u002Fsub>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n  \u003Ctd align=\"center\" width=\"20%\">🎒\u003Cbr\u002F>\u003Cb>Farah\u003C\u002Fb> · 16\u003Cbr\u002F>\u003Csub>High-school student\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">📮\u003Cbr\u002F>\u003Cb>George\u003C\u002Fb> · 68\u003Cbr\u002F>\u003Csub>Retired postman\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">💻\u003Cbr\u002F>\u003Cb>Hana\u003C\u002Fb> · 28\u003Cbr\u002F>\u003Csub>Remote software engineer\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🦺\u003Cbr\u002F>\u003Cb>Ivan\u003C\u002Fb> · 52\u003Cbr\u002F>\u003Csub>Public-safety volunteer\u003C\u002Fsub>\u003C\u002Ftd>\n  \u003Ctd align=\"center\" width=\"20%\">🍅\u003Cbr\u002F>\u003Cb>Mei\u003C\u002Fb> · 47\u003Cbr\u002F>\u003Csub>Market vegetable vendor\u003C\u002Fsub>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Csub>Every resident carries a full profile: age, family, housing, economic status, health, daily routine, skills, needs, worries, secrets, social network, language style, quirks, short- & long-term goals.\u003C\u002Fsub>\n\n### 🏫 PKU Trump Visit\n\nA campus public-situation experiment on a stylized PKU map. Daily routines begin around gates, classrooms, library, lake, dining hall, dormitory, and Centennial Hall, then a high-attention visit event tests how residents notice, ask, gather, and react.\n\n➡️ **Choose `pku_trump_visit` in the Setup Wizard to make this the current experiment.** It is bound to `hypothesis_pku_trump_visit\u002Fexperiment_1` and the `pku` map.\n\n➡️ See [`hypothesis_pku_trump_visit\u002Fexperiment_1\u002F`](agentsociety\u002Fquick_experiments\u002Fhypothesis_pku_trump_visit\u002Fexperiment_1\u002FREADME.md) for the full scenario, cast, operator notes, and replay data.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fscreenshots\u002Fmap-pku.png\" alt=\"PKU campus map\" width=\"94%\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Csub>PKU campus map — gates, classrooms, library, Weiming Lake, Boya Pagoda, dining hall, dorm, and Centennial Hall, with named residents and the Trump-visit cast.\u003C\u002Fsub>\u003C\u002Fp>\n\n## 🗺️ Pluggable Map Packages\n\nGOD now discovers map packages automatically from `agentsociety\u002Fcustom\u002Fmaps\u002F\u003Cmap_id>\u002F`. To add a map, copy [`agentsociety\u002Fcustom\u002Fmaps\u002F_template\u002F`](agentsociety\u002Fcustom\u002Fmaps\u002F_template\u002F), replace `map.yaml`, `visuals\u002Fmap.json`, tileset PNGs, and optional `characters\u002F` or `location_assets\u002F`, then run:\n\n```bash\ncd agentsociety\nuv run python scripts\u002Fvalidate_map_package.py custom\u002Fmaps\u002F\u003Cmap_id>\n```\n\nThe setup wizard will list valid packages without code changes. v1 supports Tiled JSON maps with PNG tilesets and a `Collisions` layer where `0` means walkable. The PKU campus package now ships in the repository at `agentsociety\u002Fcustom\u002Fmaps\u002Fpku\u002F`. See [docs\u002FMAP_PACKAGES.md](docs\u002FMAP_PACKAGES.md) for the full package contract.\n\n## 🛣️ Roadmap\n\n### ✅ Completed\n\n- [x] 🗺️ **Pluggable map packages** — drop a folder under `agentsociety\u002Fcustom\u002Fmaps\u002F\u003Cmap_id>\u002F`, refresh the wizard, and a new world is selectable. Auto-discovered, validated, hot-swappable. See [`docs\u002FMAP_PACKAGES.md`](docs\u002FMAP_PACKAGES.md).\n- [x] 🏫 **PKU campus map** — the PKU map package is bundled as a first-class map alongside The Ville.\n- [x] 🪄 **No-code setup wizard** — a browser flow that turns a blank machine into a live society, with model setup, built-in experiment choice, and custom experiment publishing.\n- [x] 🧪 **Scripted experiments** — reproducible experiments ship as plain folders under `quick_experiments\u002F\u003Chypothesis>\u002F\u003Cexperiment>\u002F`; choosing or publishing one makes it the current experiment.\n\n### 🛣️ Not Yet Done\n\n- [ ] 🤖 **Pluggable agent runtimes** — swap LLM runtimes and persona templates as cleanly as we now swap maps.\n- [ ] 🧪 **Multi-experiment orchestration** — run experiments, control groups, and repeats side-by-side.\n- [ ] 🗺️ **Live map generation** — maps that evolve with events, repairs, blockages, and crowds.\n- [ ] 🌦️ **Event-responsive worlds** — weather, accidents, festivals, rumors, shortages.\n- [ ] 🌐 **Large-scale simulation** — AgentSociety batching, sharded runs, sampled replay.\n- [ ] 📊 **Experiment evaluation** — cross-run metrics, behavior diffs, intervention analysis.\n- [ ] 📝 **Operator workflow** — per-step notes, tags, bookmarks, key-event summaries.\n- [ ] 🌍 **Hosted demo & scenario sharing** — public demo, experiment and map templates.\n\nHave an idea? [Open an issue or PR](#-contributing).\n\n## 🤝 Contributing\n\nIssues and pull requests are very welcome. To set up a dev environment:\n\n```bash\n.\u002Fscripts\u002Fgod.sh start\n```\n\nThat installs Python and Node dependencies, brings up the full stack, creates a live session, and runs the first step so the control room opens on a populated town. From there, edit and reload.\n\nFull guide: **[CONTRIBUTING.md →](CONTRIBUTING.md)** — branching, PR checklist, style, and how to ship a new map or experiment.\n\n## 🙌 Acknowledgements\n\nGOD stands on the shoulders of open research and open-source. It bundles two trimmed, integrated upstream checkouts:\n\n- [AgentSociety](https:\u002F\u002Fgithub.com\u002Ftsinghua-fib-lab\u002FAgentSociety) — large-scale generative-agent simulation framework.\n- [JiuwenClaw](https:\u002F\u002Fgithub.com\u002FopenJiuwen-ai\u002Fjiuwenclaw) — out-of-process agent runtime.\n\nAnd takes inspiration from [Generative Agents](https:\u002F\u002Farxiv.org\u002Fabs\u002F2304.03442) and [OASIS](https:\u002F\u002Fgithub.com\u002Fcamel-ai\u002Foasis).\n\n## 📚 Citation\n\n```bibtex\n@article{piao2025agentsociety,\n  title   = {AgentSociety: Large-Scale Simulation of LLM-Driven Generative Agents Advances Understanding of Human Behaviors and Society},\n  author  = {Piao et al.},\n  journal = {arXiv preprint arXiv:2502.08691},\n  year    = {2025}\n}\n\n@misc{park2023generativeagents,\n  title         = {Generative Agents: Interactive Simulacra of Human Behavior},\n  author        = {Joon Sung Park and Joseph C. O'Brien and Carrie J. Cai and Meredith Ringel Morris and Percy Liang and Michael S. Bernstein},\n  year          = {2023},\n  eprint        = {2304.03442},\n  archivePrefix = {arXiv},\n  primaryClass  = {cs.HC},\n  url           = {https:\u002F\u002Farxiv.org\u002Fabs\u002F2304.03442}\n}\n```\n\n## ⭐ Star History\n\n\u003Ca href=\"https:\u002F\u002Fstar-history.com\u002F#XiaoLuoLYG\u002FGOD&Date\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=XiaoLuoLYG\u002FGOD&type=Date&theme=dark\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=XiaoLuoLYG\u002FGOD&type=Date\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=XiaoLuoLYG\u002FGOD&type=Date\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n## 📄 License\n\nReleased under the [Apache-2.0](LICENSE) license. Upstream LICENSE and NOTICE files are kept inside the integrated runtime checkouts and apply to those subtrees.\n\n\u003Cp align=\"center\">\u003Csub>Built with care. ⭐ a star helps GOD grow.\u003C\u002Fsub>\u003C\u002Fp>\n","GOD项目是一个实时控制室，用于管理和观察代理社会。它允许用户暂停时间、与特定代理交流、即时修改下一步行动，并重置整个模拟环境，提供了对代理行为的深度控制。基于Python开发，前端使用React构建界面，支持无代码配置和OpenAI兼容性，使得设置和操作都十分便捷。该项目适用于需要高度互动性和可控性的多代理仿真场景，如社交模拟、教育工具或复杂系统研究等。",2,"2026-06-11 03:56:17","CREATED_QUERY"]