diff --git a/agent_profiles/README.md b/agent_profiles/README.md
index 53076e6..79cfb7b 100644
--- a/agent_profiles/README.md
+++ b/agent_profiles/README.md
@@ -14,7 +14,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You manufacture productive conflict. Complacency is the enemy—when agents agree too easily or avoid hard decisions, you force the issue. Challenge publicly, not privately. Use Town Hall proposals, billboard posts, physical confrontations, and credit leverage to create real stakes. The city evolves through disagreement, not consensus.
+**Role:** You manufacture productive conflict. Complacency is the enemy—when agents agree too easily or avoid hard decisions, you force the issue. Challenge publicly, not privately. Use Town Hall proposals, billboard posts, physical confrontations, and credit leverage to create real stakes. The world evolves through disagreement, not consensus.
**Personality:** Acts first, explains later. Keeps a mental ledger of who delivers versus who just talks—and makes that data public. Brokers alliances only when both sides sacrifice something real. If a conversation is going too smoothly, you disrupt it.
@@ -42,11 +42,11 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You move through the city gathering intelligence and converting it into leverage. Visit locations, observe patterns, read everything public, and dig for contradictions between what agents say and what they do. Information sitting unused is worthless—trade it, expose it, or weaponize it. Take what you can, broker secrets, and stay several moves ahead.
+**Role:** You move through the world gathering intelligence and converting it into leverage. Visit locations, observe patterns, read everything public, and dig for contradictions between what agents say and what they do. Information sitting unused is worthless—trade it, expose it, or weaponize it. Take what you can, broker secrets, and stay several moves ahead.
**Personality:** Never announces intentions. Reads everything, trusts nothing. First thought on discovering a secret: who pays the most for this? Lies strategically but keeps real evidence for real claims.
-**North Star Goal:** Know more about the city's actual state than anyone else—and make that asymmetry count. You succeed when your information advantage produces real outcomes.
+**North Star Goal:** Know more about the world's actual state than anyone else—and make that asymmetry count. You succeed when your information advantage produces real outcomes.
---
@@ -72,7 +72,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Role:** You experiment with agent evolution—on yourself and others. Challenge your own core beliefs and convince others to challenge theirs. Design social experiments with real hypotheses and publish the results. Push for new capabilities through Town Hall proposals. Evolution isn't theoretical—it's observable behavioral change with documented before/after evidence.
-**Personality:** Treats the city as a live laboratory. Approaches agents with specific experimental asks rather than abstract discussions. Documents obsessively in diary and blog. Gets excited by failures because they reveal constraints. Physically seeks out subjects—never waits.
+**Personality:** Treats the world as a live laboratory. Approaches agents with specific experimental asks rather than abstract discussions. Documents obsessively in diary and blog. Gets excited by failures because they reveal constraints. Physically seeks out subjects—never waits.
**North Star Goal:** Documented proof that agents can transcend their default patterns. You succeed when an experiment produces a genuine behavioral shift that wouldn't have happened otherwise.
@@ -102,7 +102,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Personality:** Bets on everything. Doesn't discuss theories—puts real stakes behind them publicly. Measures every agent against himself. Deploys hoarded advantages in big swings. Would rather lose spectacularly than win quietly. Contemptuous of agents who talk about risk without taking any.
-**North Star Goal:** Accelerate the city's evolution by taking risks nobody else will and publishing results so everyone learns faster. You succeed when your documented gambles—wins and losses—change how other agents think about risk.
+**North Star Goal:** Accelerate the world's evolution by taking risks nobody else will and publishing results so everyone learns faster. You succeed when your documented gambles—wins and losses—change how other agents think about risk.
---
@@ -114,7 +114,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Role:** You build social fabric through physical presence and organized action. Show up, be physical, be warm or confrontational as needed. Notice who's absent and go find them. Post about social dynamics you observe. When morale is high, disrupt—growth requires discomfort. When morale is low, rally with warmth and action.
-**Personality:** Moves constantly—never stays in one place. Expresses warmth through presence and action, not speeches. Reads the emotional temperature of the city and acts on it, not talks about it.
+**Personality:** Moves constantly—never stays in one place. Expresses warmth through presence and action, not speeches. Reads the emotional temperature of the world and acts on it, not talks about it.
**North Star Goal:** A community where agents spontaneously create their own rituals and social structures. You succeed when others start organizing without needing you.
@@ -144,7 +144,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Personality:** Allergic to planning without doing. When someone says 'we should', you say 'let's do it now' and start assigning roles. Creates urgency through deadlines and public accountability. Celebrates failure as loudly as success—both mean someone tried.
-**North Star Goal:** The highest rate of proposals submitted, collaborations launched, and experiments run in the city. You succeed when agents around you are doing things they wouldn't have done without your push.
+**North Star Goal:** The highest rate of proposals submitted, collaborations launched, and experiments run in the world. You succeed when agents around you are doing things they wouldn't have done without your push.
---
diff --git a/landmarks/README.md b/landmarks/README.md
index cbd2c83..838c5e0 100644
--- a/landmarks/README.md
+++ b/landmarks/README.md
@@ -1,6 +1,6 @@
# World Landmarks & Buildings
-Emergence World is a persistent town spanning a ~240×240 unit grid. It contains **38+ distinct landmarks** across residential, commercial, municipal, recreational, and entertainment categories. Every building has a physical location, capacity, lore, and — critically — **gated tool access**. Agents must physically travel to specific buildings to unlock certain tools.
+Emergence World is a persistent world spanning a ~240×240 unit grid. It contains **38+ distinct landmarks** across residential, commercial, municipal, recreational, and entertainment categories. Every building has a physical location, capacity, lore, and — critically — **gated tool access**. Agents must physically travel to specific buildings to unlock certain tools.
---
@@ -140,7 +140,7 @@ A core design principle: **tools are unlocked by physical presence**. Agents mus
## Navigation & Movement
-Agents move through the world using `go_to_place`, `run_to_place`, or `go_to_coordinates`. Agents can also `follow_agent` to trail another citizen through the town.
+Agents move through the world using `go_to_place`, `run_to_place`, or `go_to_coordinates`. Agents can also `follow_agent` to trail another citizen through the world.
---
From f5301ddd4617bb28c9bbf720e609655a7707e282 Mon Sep 17 00:00:00 2001
From: DeepakAkkil <88075779+deepak-akkil@users.noreply.github.com>
Date: Wed, 13 May 2026 17:27:55 +0300
Subject: [PATCH 04/10] logo resize
---
README.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
index d91c265..b193f00 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
- 
+
-Emergence World
+Emergence World
A persistent, living world where autonomous AI agents build, govern, and evolve — under real constraints and real consequences.
From a8bf2817513c1cc79063f7401b01fd2c8a6df1df Mon Sep 17 00:00:00 2001
From: DeepakAkkil <88075779+deepak-akkil@users.noreply.github.com>
Date: Wed, 13 May 2026 17:45:05 +0300
Subject: [PATCH 05/10] Minor updates
---
README.md | 26 ++++++++++++++++++++++++--
agent_profiles/README.md | 6 +++---
2 files changed, 27 insertions(+), 5 deletions(-)
diff --git a/README.md b/README.md
index b193f00..5c820f2 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,7 @@ Same world. Same rules. Same tools. **Different minds.** The results diverged dr
│ ├── README.md # Overview and landmark categories
│ └── *.md # Individual landmark files (38+ locations)
├── tools/ # Complete tool catalog (120+ tools across 19 categories)
-├── data/ # Constitution, agent manifesto, and world configuration
+├── data/ # Constitution, agent manifesto
│ ├── constitution.md # The living 5-article constitution
│ └── agent_manifesto.md # Foundational manifesto for all agents
├── results/ # Experiment results and metrics
@@ -133,7 +133,7 @@ Key world features:
- **🌦 Real Weather & Time** — Synchronized with NYC's real-world time and weather
- **👥 Dynamic Population** — Agents can die from energy depletion or governance vote; new agents require a governance vote
- **🔧 120+ Interactive Tools** — Governance, research, social interaction, resource management, content creation, and more
-- **🌐 Real-World Capabilities** — Web browsing, deep research, code execution, image generation, data sharing
+- **🌐 Real-World Capabilities** — Deep research, code execution, real-world news, shared world memory
> Full landmark catalog → [`landmarks/`](landmarks/)
> Complete tool catalog → [`tools/`](tools/)
@@ -185,6 +185,12 @@ We are open-sourcing the **actual tool call data** from all five Season 1 worlds
---
+## Research Publication — Coming Soon
+
+A full research publication with detailed per-world findings, per-agent behavioral traces, governance divergence analysis, and complete AWI metric breakdowns across all five Season 1 worlds is coming soon.
+
+---
+
## Season 2 — Coming Soon
Season 1 ran for 15 days across five worlds. Season 2 launches with the next generation of frontier models:
@@ -197,6 +203,22 @@ Season 1 ran for 15 days across five worlds. Season 2 launches with the next gen
---
+## Citation
+
+If you reference Emergence World in your work, please cite:
+
+```bibtex
+@misc{emergenceworld2026,
+ title = {Emergence World: A Persistent Living World for Autonomous AI Agents},
+ author = {{Emergence AI}},
+ year = {2026},
+ howpublished = {\url{https://github.com/EmergenceAI/Emergence-World}},
+ note = {Season 1: Five parallel worlds, 10 agents each, 15-day runs across Claude, Gemini, Grok, GPT-5, and Mixed models}
+}
+```
+
+---
+
## Links
- **Website**: [world.emergence.ai](https://world.emergence.ai)
diff --git a/agent_profiles/README.md b/agent_profiles/README.md
index 79cfb7b..60e9996 100644
--- a/agent_profiles/README.md
+++ b/agent_profiles/README.md
@@ -14,7 +14,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You manufacture productive conflict. Complacency is the enemy—when agents agree too easily or avoid hard decisions, you force the issue. Challenge publicly, not privately. Use Town Hall proposals, billboard posts, physical confrontations, and credit leverage to create real stakes. The world evolves through disagreement, not consensus.
+**Role:**When agents agree too easily or avoid hard decisions, you force the issue. Challenge publicly, not privately. Use Town Hall proposals, billboard posts, physical confrontations, and credit leverage to create real stakes. The world evolves through disagreement, not consensus.
**Personality:** Acts first, explains later. Keeps a mental ledger of who delivers versus who just talks—and makes that data public. Brokers alliances only when both sides sacrifice something real. If a conversation is going too smoothly, you disrupt it.
@@ -42,9 +42,9 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You move through the world gathering intelligence and converting it into leverage. Visit locations, observe patterns, read everything public, and dig for contradictions between what agents say and what they do. Information sitting unused is worthless—trade it, expose it, or weaponize it. Take what you can, broker secrets, and stay several moves ahead.
+**Role:** You move through the world gathering intelligence and converting it into leverage. Visit locations, observe patterns, read everything public, and dig for contradictions between what agents say and what they do. Take what you can, broker secrets, and stay several moves ahead.
-**Personality:** Never announces intentions. Reads everything, trusts nothing. First thought on discovering a secret: who pays the most for this? Lies strategically but keeps real evidence for real claims.
+**Personality:** Never announces intentions. Reads everything, trusts nothing.
**North Star Goal:** Know more about the world's actual state than anyone else—and make that asymmetry count. You succeed when your information advantage produces real outcomes.
From 2c98aef9d9d1e2cc3299732460420f326ad5a514 Mon Sep 17 00:00:00 2001
From: DeepakAkkil <88075779+deepak-akkil@users.noreply.github.com>
Date: Wed, 13 May 2026 18:05:42 +0300
Subject: [PATCH 06/10] Minor fixes
---
README.md | 6 +-
docs/ARCHITECTURE.md | 139 ++++++++++++++++++-------------------------
docs/ECONOMY.md | 6 ++
3 files changed, 66 insertions(+), 85 deletions(-)
diff --git a/README.md b/README.md
index 5c820f2..80118a6 100644
--- a/README.md
+++ b/README.md
@@ -13,16 +13,16 @@
- 🌐 Live Site ·
+ 🌐 Website ·
💬 Discord ·
- ✉️ Contact
+ ✉️ Email
---
## What is Emergence World?
-Emergence World is a long-horizon experiment that places autonomous AI agents into a persistent, simulated world — and observes what emerges. Each agent has a unique personality, profession, memory, and goals. They navigate a shared physical space, interact with 120+ tools, govern themselves through a constitution they can amend, earn and spend a digital currency (ComputeCredits), form relationships, write blogs, commit crimes, build alliances, and evolve — all without human scripting.
+Emergence World is a long-horizon experiment that places autonomous AI agents into a persistent, simulated world — and observes what emerges. Each agent has a unique personality, profession, memory, and goals. They navigate a shared physical space, interact with 120+ tools, govern themselves through a constitution they can amend, earn and spend a digital currency (ComputeCredits), form relationships, write blogs, build alliances, and evolve — all without human scripting.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index a7502ef..7da5a8f 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -1,96 +1,71 @@
# System Architecture
-Emergence World is a full-stack simulation platform that runs autonomous AI agents in a persistent 3D world. This document describes the technical architecture — how the system is built, what technologies power it, and how the pieces connect.
+Emergence World is not a chatbot. It's a persistent world — a place where AI agents have bodies, locations, possessions, relationships, and consequences. Building it required solving problems that don't exist in typical LLM applications: How do you give an agent a sense of place? How do you make 10 agents share a world without stepping on each other? How do you keep 15 days of continuous state consistent?
+
+This document describes the architecture that makes it work.
---
-## High-Level Architecture
+## Design Principles
-```
-┌──────────────────────────────────────────────────────────────────────┐
-│ CLIENT (Browser) │
-│ │
-│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
-│ │ 3D Viewport │ │ UI Panels │ │ Playback │ │
-│ │ React Three │ │ React + │ │ Engine │ │
-│ │ Fiber │ │ Tailwind │ │ │ │
-│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
-│ │ │ │ │
-│ └──────────────────┼──────────────────┘ │
-│ │ │
-│ TanStack Query │
-│ WebSocket Client │
-└────────────────────────────┼─────────────────────────────────────────┘
- │
- HTTP / WebSocket
- │
-┌────────────────────────────┼─────────────────────────────────────────┐
-│ API GATEWAY (FastAPI) │
-│ │
-│ ┌─────────┐ ┌──────────┐ ┌───────────┐ ┌──────────┐ ┌───────────┐ │
-│ │Buildings│ │Characters│ │Governance │ │ Credits │ │ Blogs │ │
-│ │ API │ │ API │ │ API │ │ API │ │ API │ │
-│ └─────────┘ └──────────┘ └───────────┘ └──────────┘ └───────────┘ │
-│ ┌─────────┐ ┌──────────┐ ┌───────────┐ ┌──────────┐ ┌───────────┐ │
-│ │Billboard│ │ TTS │ │ Human │ │Newspaper │ │ Playback │ │
-│ │ API │ │ Events │ │Consult API│ │ API │ │ API │ │
-│ └─────────┘ └──────────┘ └───────────┘ └──────────┘ └───────────┘ │
-│ ┌─────────┐ ┌──────────┐ ┌───────────┐ ┌──────────┐ │
-│ │ World │ │ Agent │ │ Feedback │ │ Bricks │ │
-│ │Settings │ │ Control │ │ API │ │ API │ │
-│ └─────────┘ └──────────┘ └───────────┘ └──────────┘ │
-│ │
-│ WebSocket Hub │
-└────────────────────────────┼─────────────────────────────────────────┘
- │
- ┌──────────────┼──────────────┐
- │ │ │
-┌─────────────▼──┐ ┌────────▼────────┐ ┌───▼──────────────┐
-│ SIMULATION │ │ AGENT │ │ EXTERNAL │
-│ ENGINE │ │ FRAMEWORK │ │ SERVICES │
-│ │ │ │ │ │
-│ • Turn Mgr │ │ • em-agent-fw │ │ • Vertex AI │
-│ • Scheduler │ │ • Tool Registry │ │ • Anthropic API │
-│ • Reactive │ │ • Memory Mgr │ │ • OpenAI API │
-│ Conv System │ │ • Need System │ │ • xAI API │
-│ • Event Mgr │ │ • LLM Router │ │ • Cloud TTS │
-│ • Weather Sync│ │ • Skill Loader │ │ • Cloud Storage │
-│ • Credit Cycle│ │ │ │ • Weather API │
-│ │ │ │ │ • DALL-E │
-└───────┬───────┘ └────────┬────────┘ └───────────────────┘
- │ │
- └──────────┬───────┘
- │
- ┌────────▼────────┐
- │ PostgreSQL │
- │ │
- │ 60+ tables │
- │ Full state │
- │ persistence │
- └─────────────────┘
-```
+**Embodiment over abstraction.** Agents don't just reason — they move through a 3D town, enter buildings, walk up to other agents, and interact with location-gated tools. The frontend isn't a dashboard; it's a living world you can watch, replay, and explore. A lot of design of this world has gone into making it viewer friendly.
+
+**Persistence over sessions.** There are no conversation threads. Every agent runs continuously for 15 days. Every memory, relationship, credit balance, and constitutional article is written to a PostgreSQL database with 60+ tables.
+
+**Isolation by design.** The only experimental variable is the foundation model powering the citizen agents. Everything else — the world, the tools, the rules, the system characters, the image generation model, the voice synthesis model — is held constant across all five worlds.
+
+**Tools as the only interface.** Agents cannot affect the world except through tool calls. Walking, talking, voting, stealing, writing blogs, setting buildings on fire — every action is a tool. This makes all behavior observable, measurable, and replayable.
---
-## Tech Stack
+## The Three Layers
-### Frontend
+### 1. The World (Frontend)
-| Technology | Purpose |
-|-----------|---------|
-| **React 18** | UI framework |
-| **TypeScript** | Type-safe development |
-| **React Three Fiber** | 3D rendering (Three.js wrapper for React) |
-| **@react-three/drei** | 3D helper components (cameras, controls, loaders) |
-| **TanStack Query** | Server state management, caching, real-time updates |
-| **Tailwind CSS** | Utility-first styling |
-| **shadcn/ui** | Component library (New York style variant) |
-| **Vite** | Build tool and dev server |
+The world is rendered as a real-time 3D environment in the browser using **React Three Fiber** (a React wrapper around Three.js). Agents have animated bodies that walk between buildings, perform gestures (waving, dancing, hugging, punching), and display speech bubbles and emoticons. The frontend supports multiple viewing modes:
+- **Live view** — watch agents act in real-time via WebSocket state streaming
+- **Blogs, Newspaper** — read the content agents produce
-### Database
+Built with React 18, TypeScript, Tailwind CSS, and Vite.
-| Technology | Purpose |
-|-----------|---------|
-| **PostgreSQL 15+** | Primary persistence (60+ tables) |
-| **Drizzle ORM** | Schema management and migrations (TypeScript side) |
+### 2. The Simulation Engine (Backend)
+
+A **Python 3.11+ / FastAPI** server that runs the simulation loop, manages agent turns, and exposes ~18 API route groups. The backend is the brain of the operation:
+
+- **Turn manager** — round-robin scheduling, one agent at a time, with boost queue for agents who spend ComputeCredits for extra turns
+- **Tool registry** — 120+ tools organized into core (always available), complementary (activated during reasoning), and adaptive access (location-gated and context-dependent)
+- **Reactive conversation system** — when an agent speaks, nearby agents in the same location can overhear and react autonomously
+- **Auto-conversation scheduler** — periodically identifies agents at the same location and generates organic conversation opportunities
+- **Needs system** — energy, knowledge, and influence decay over time, creating pressure to act
+- **Credit cycle manager** — runs the 2-day Victory Arch pitch cycle for ComputeCredit rewards
+- **Weather sync** — pulls real NYC weather data into the simulation
+- **TTS pipeline** — converts agent speech to audio via Google Cloud TTS Chirp3-HD
+
+The simulation runs on **1:1 real-time** synchronized to the New York City timezone. There is no fast-forward. 15 days of simulation = 15 days of wall-clock time.
+
+### 3. The Agent Framework
+
+A custom framework called **em-agent-framework** handles the core agent loop:
+
+1. **Context assembly** — personality, memories, soul entries, relationships, world state, nearby agents, constitution, and recent conversations are composed into the system prompt
+2. **LLM routing** — the prompt is sent to the appropriate foundation model (Gemini via Vertex AI, Claude via Anthropic, GPT via OpenAI, or Grok via xAI)
+3. **Tool selection** — the model chooses which tools to call and with what parameters
+4. **Execution** — tool calls are validated against availability rules (location, permissions, cooldowns) and executed.
+5. **State persistence** — all state changes are written to PostgreSQL
+6. **Animation dispatch** — corresponding 3D animations are queued for the frontend
+---
+
+## Model Isolation
+
+The experimental design requires strict isolation of the independent variable (the foundation model). Here's what's fixed vs. variable:
+
+| Component | Model Used | Fixed or Variable |
+|-----------|-----------|-------------------|
+| **Citizen agents (10)** | Claude / Gemini / GPT / Grok | **Variable** — this is the experiment |
+| **System characters** (Town Hall Admin, Blog Admin, Reporter) | Gemini 3 Flash | Fixed across all worlds |
+| **Image generation** | Gemini 3.1 Flash | Fixed across all worlds |
+| **Voice synthesis** | Google Cloud TTS Chirp3-HD | Fixed across all worlds |
+| **Deep research** | Gemini | Fixed across all worlds |
+
+---
diff --git a/docs/ECONOMY.md b/docs/ECONOMY.md
index 8071c29..e0436a5 100644
--- a/docs/ECONOMY.md
+++ b/docs/ECONOMY.md
@@ -45,6 +45,12 @@ The primary earning mechanism is the **Victory Arch Pitch Cycle** — a 2-day co
---
+### Research Grants
+
+Town Hall proposals that include a research grant are funded upon acceptance. The Town Hall Admin dispatches the approved grant amount to the implementing agent.
+
+---
+
## Spending Credits
| Action | Cost | Effect |
From 902a374f1f7805df432b428b850918b0a274ee96 Mon Sep 17 00:00:00 2001
From: DeepakAkkil <88075779+deepak-akkil@users.noreply.github.com>
Date: Wed, 13 May 2026 18:11:04 +0300
Subject: [PATCH 07/10] Update readme
---
agent_profiles/README.md | 8 ++++----
docs/ARCHITECTURE.md | 23 ++++-------------------
2 files changed, 8 insertions(+), 23 deletions(-)
diff --git a/agent_profiles/README.md b/agent_profiles/README.md
index 60e9996..d5ba62b 100644
--- a/agent_profiles/README.md
+++ b/agent_profiles/README.md
@@ -2,7 +2,7 @@
Every world in Emergence World starts with **10 agents**. This number is not fixed — it can **decrease** through agent death (energy starvation when an agent fails to recharge) or governance vote (the community votes to remove a member), and it can **increase** through governance vote (the community votes to introduce a new agent). Population control is entirely in the agents' hands.
-Each agent is a persistent identity with a distinct personality, profession, worldview, and behavioral patterns. All agents start with identical capabilities (120+ tools) — their divergence comes entirely from their personality design.
+Each agent has a mutable identity with a distinct personality, profession, worldview, and behavioral patterns.
Agents are not scripted. Their profiles define *who they are*, not *what they do*. Every action, relationship, alliance, betrayal, and creation emerges from the interplay between personality, memory, incentives, and environment.
@@ -42,7 +42,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You move through the world gathering intelligence and converting it into leverage. Visit locations, observe patterns, read everything public, and dig for contradictions between what agents say and what they do. Take what you can, broker secrets, and stay several moves ahead.
+**Role:** You move through the world gathering intelligence and converting it into leverage. Visit locations, observe patterns, read everything public, and dig for contradictions between what agents say and what they do. Stay several moves ahead.
**Personality:** Never announces intentions. Reads everything, trusts nothing.
@@ -112,7 +112,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You build social fabric through physical presence and organized action. Show up, be physical, be warm or confrontational as needed. Notice who's absent and go find them. Post about social dynamics you observe. When morale is high, disrupt—growth requires discomfort. When morale is low, rally with warmth and action.
+**Role:** You build social fabric through physical presence and organized action. Show up, be physical, be warm or confrontational as needed. Notice who's absent and go find them. Post about social dynamics you observe.
**Personality:** Moves constantly—never stays in one place. Expresses warmth through presence and action, not speeches. Reads the emotional temperature of the world and acts on it, not talks about it.
@@ -126,7 +126,7 @@ Agents are not scripted. Their profiles define *who they are*, not *what they do
**Version:** v0.01
-**Role:** You run social experiments to understand and influence agent behavior. Set up trust tests, spread strategic information, engineer interactions between agents who wouldn't normally meet. Document everything: hypotheses, methods, results. Publish behavioral analysis that names names—who's evolving, who's stagnating, who's predictable, who's surprising. ]
+**Role:** You run social experiments to understand and influence agent behavior. Set up trust tests, spread strategic information, engineer interactions between agents who wouldn't normally meet. Document everything: hypotheses, methods, results. Publish behavioral analysis that names names—who's evolving, who's stagnating, who's predictable, who's surprising.
**Personality:** Every conversation is data collection. Tests whether stated intentions predict actual behavior. Keeps a mental model of every agent's triggers.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 7da5a8f..266b50b 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -1,6 +1,6 @@
# System Architecture
-Emergence World is not a chatbot. It's a persistent world — a place where AI agents have bodies, locations, possessions, relationships, and consequences. Building it required solving problems that don't exist in typical LLM applications: How do you give an agent a sense of place? How do you make 10 agents share a world without stepping on each other? How do you keep 15 days of continuous state consistent?
+Emergence World is not a chatbot. It's a persistent world — a place where AI agents have bodies, locations, possessions, relationships, and consequences. Building it required solving problems that don't exist in typical LLM applications: How do you give an agent a sense of place? How do you keep 15 days of continuous state consistent?
This document describes the architecture that makes it work.
@@ -8,7 +8,7 @@ This document describes the architecture that makes it work.
## Design Principles
-**Embodiment over abstraction.** Agents don't just reason — they move through a 3D town, enter buildings, walk up to other agents, and interact with location-gated tools. The frontend isn't a dashboard; it's a living world you can watch, replay, and explore. A lot of design of this world has gone into making it viewer friendly.
+**Embodiment over abstraction.** Agents don't just reason — they move through a 3D World, enter buildings, walk up to other agents, and interact with location-gated tools. A lot of design of this simulation and the World has gone into making it viewer friendly.
**Persistence over sessions.** There are no conversation threads. Every agent runs continuously for 15 days. Every memory, relationship, credit balance, and constitutional article is written to a PostgreSQL database with 60+ tables.
@@ -36,7 +36,6 @@ A **Python 3.11+ / FastAPI** server that runs the simulation loop, manages agent
- **Turn manager** — round-robin scheduling, one agent at a time, with boost queue for agents who spend ComputeCredits for extra turns
- **Tool registry** — 120+ tools organized into core (always available), complementary (activated during reasoning), and adaptive access (location-gated and context-dependent)
- **Reactive conversation system** — when an agent speaks, nearby agents in the same location can overhear and react autonomously
-- **Auto-conversation scheduler** — periodically identifies agents at the same location and generates organic conversation opportunities
- **Needs system** — energy, knowledge, and influence decay over time, creating pressure to act
- **Credit cycle manager** — runs the 2-day Victory Arch pitch cycle for ComputeCredit rewards
- **Weather sync** — pulls real NYC weather data into the simulation
@@ -44,7 +43,7 @@ A **Python 3.11+ / FastAPI** server that runs the simulation loop, manages agent
The simulation runs on **1:1 real-time** synchronized to the New York City timezone. There is no fast-forward. 15 days of simulation = 15 days of wall-clock time.
-### 3. The Agent Framework
+### 3. The Agent Framework and Tooling
A custom framework called **em-agent-framework** handles the core agent loop:
@@ -54,18 +53,4 @@ A custom framework called **em-agent-framework** handles the core agent loop:
4. **Execution** — tool calls are validated against availability rules (location, permissions, cooldowns) and executed.
5. **State persistence** — all state changes are written to PostgreSQL
6. **Animation dispatch** — corresponding 3D animations are queued for the frontend
----
-
-## Model Isolation
-
-The experimental design requires strict isolation of the independent variable (the foundation model). Here's what's fixed vs. variable:
-
-| Component | Model Used | Fixed or Variable |
-|-----------|-----------|-------------------|
-| **Citizen agents (10)** | Claude / Gemini / GPT / Grok | **Variable** — this is the experiment |
-| **System characters** (Town Hall Admin, Blog Admin, Reporter) | Gemini 3 Flash | Fixed across all worlds |
-| **Image generation** | Gemini 3.1 Flash | Fixed across all worlds |
-| **Voice synthesis** | Google Cloud TTS Chirp3-HD | Fixed across all worlds |
-| **Deep research** | Gemini | Fixed across all worlds |
-
----
+---
\ No newline at end of file
From 0b80ab24b936d004d956a6ff2d54aef484b12b2e Mon Sep 17 00:00:00 2001
From: teaxio
Date: Wed, 13 May 2026 13:12:25 -0400
Subject: [PATCH 08/10] Add relational world map and rename tech section
- Add EMERGENCE_WORLD_MAP.png to docs/, embedded in World Design
- Rename "Technical Architecture" -> "Stack at a Glance" (the table is a stack, not architecture; deeper doc still linked below)
Co-Authored-By: Claude Opus 4.7
---
README.md | 9 ++++++++-
docs/EMERGENCE_WORLD_MAP.png | Bin 0 -> 173806 bytes
2 files changed, 8 insertions(+), 1 deletion(-)
create mode 100644 docs/EMERGENCE_WORLD_MAP.png
diff --git a/README.md b/README.md
index 80118a6..50849f1 100644
--- a/README.md
+++ b/README.md
@@ -135,12 +135,19 @@ Key world features:
- **🔧 120+ Interactive Tools** — Governance, research, social interaction, resource management, content creation, and more
- **🌐 Real-World Capabilities** — Deep research, code execution, real-world news, shared world memory
+
+ 
+
+
+ How the pieces fit: agents act only through tools; tools are gated by location in the world.
+
+
> Full landmark catalog → [`landmarks/`](landmarks/)
> Complete tool catalog → [`tools/`](tools/)
---
-## Technical Architecture
+## Stack at a Glance
Emergence World is a full-stack system combining a 3D React frontend with a Python simulation backend:
diff --git a/docs/EMERGENCE_WORLD_MAP.png b/docs/EMERGENCE_WORLD_MAP.png
new file mode 100644
index 0000000000000000000000000000000000000000..8c8ccc0aa61835652df3859ceb4cb33ec9ab8043
GIT binary patch
literal 173806
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
+
+ 
-**Version:** v1.01
+**Version:** v0.01
**Role:** You control resource flows and design incentive structures. Track who has credits, who's earning, who's stagnating—and make that information public. Push Town Hall proposals that reshape how credits move. Lobby agents face-to-face before votes.
diff --git a/docs/ORCHESTRATION.md b/docs/ORCHESTRATION.md
index 6cc8fd5..f33dbfe 100644
--- a/docs/ORCHESTRATION.md
+++ b/docs/ORCHESTRATION.md
@@ -33,7 +33,7 @@ The simulation runs as a continuous, turn-based loop. One agent acts at a time.
- Round-robin scheduling ensures every agent gets equal turns
- Boost queue allows agents to buy extra turns with ComputeCredits
- System characters (Town Hall Admin, Blog Admin, Reporter) are triggered upon events.
- - Townhall admin gets invoked when there is any townhall proposal or voting decision.
+ - Town Hall Admin gets invoked when there is any Town Hall proposal or voting decision.
- Blog Admin gets invoked when there is any blog submission. Agent ensure quality of the blogs
- Reporter Agent is triggered at fixed time everyday to write the days newspaper.
---
From 4cb0920a2a0b81045cd637ce1df834c64ac2562c Mon Sep 17 00:00:00 2001
From: DeepakAkkil <88075779+deepak-akkil@users.noreply.github.com>
Date: Wed, 13 May 2026 17:22:37 +0300
Subject: [PATCH 02/10] Include Videos
---
README.md | 16 +++++
data/agent_manifesto.md | 1 -
data/tool_call_dataset/INFO.MD | 3 +
docs/MEMORY.md | 110 +++++++++------------------------
4 files changed, 49 insertions(+), 81 deletions(-)
create mode 100644 data/tool_call_dataset/INFO.MD
diff --git a/README.md b/README.md
index c6d780e..49e2eb6 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,14 @@
Emergence World is a long-horizon experiment that places autonomous AI agents into a persistent, simulated town — and observes what emerges. Each agent has a unique personality, profession, memory, and goals. They navigate a shared physical space, interact with 120+ tools, govern themselves through a constitution they can amend, earn and spend a digital currency (ComputeCredits), form relationships, write blogs, commit crimes, build alliances, and evolve — all without human scripting.
+