WorldSeed

A YAML-defined world engine for running, observing, and steering emergent multi-agent scenarios.

Stars
★ 824
Last updated
6mo ago
License
MIT
Primary language
Python

At a glance

How it runs
CLIWeb app
Works with
Universal · cross-platformCodex · OpenAI API · Claude API
Cost
Free software; you pay for model usage
Setup effort
Medium · a few setup steps
You'll need
Python 3.11+Node.js 18+uvnpmAPI key for a LiteLLM providerShell / CLINetwork accessLocal filesystem
Typical use
A research group wants specialist characters to turn an early idea into hypotheses, experiments, peer review, and an auditable research trail.
Not a fit if
  • Users who want zero-config scenes without maintaining YAML rules
  • Teams needing production deployment, hosting, or cost controls

What does this agent do, and when should you use it?

WorldSeed is a local world engine for emergent multi-agent scenarios. You define entities, roles, private information, perception filters, actions, rules, and consequences in YAML, then start a scene with the worldseed CLI. Its tick loop gives each character a filtered view of the world and resolves actions through either the YAML DSL or an LLM-based Dungeon Master that returns structured effects. A local dashboard supports observation, private intervention, and playing as a character; runs are preserved for replay. Bundled scenes include AI Layoffs and Teahouse, while documented integration paths include OpenClaw agents, Codex subagents, and models supported by LiteLLM.

Run uv run worldseed validate configs/my_scene.yaml to validate a scene YAML file, then run uv run worldseed play configs/my_scene.yaml to execute it. On every tick, WorldSeed filters state through each character's perception rules, gathers proposed actions, resolves deterministic actions with the in-YAML DSL, and sends uncertain outcomes to the LLM Dungeon Master. The Dungeon Master returns structured effects, which mutate state, trigger consequences, and are logged as the world advances. The local dashboard at http://localhost:8000 provides Watch, Intervene, and Play modes. The /create-world command generates validated YAML scene and UI configuration from a prompt, and authors can also edit files such as configs/teahouse.yaml and configs/ai_layoffs.yaml directly.

  1. A research group wants specialist characters to turn an early idea into hypotheses, experiments, peer review, and an auditable research trail.
  2. A narrative or game designer needs to test an espionage or workplace scenario involving secrets, factions, and asymmetric information.
  3. An AI-tool team wants API researchers, builders, critics, audience agents, and a curator to compete over artifacts in one traceable scene.
  4. A developer wants to experiment with social-simulation rules, perceptions, and consequence chains in YAML instead of rebuilding a domain-specific engine.
  5. An engineering team wants to connect OpenClaw agents or Codex subagents to an observable world where operators can privately influence characters.

How do you install or deploy this agent?

Requirements: Python 3.11+, Node.js 18+, and uv. Run:

git clone https://github.com/AIScientists-Dev/WorldSeed && cd WorldSeed
uv sync --extra dm

cd frontend && npm install && npm run build && cd ..

cp .env.example .env

Add credentials for a LiteLLM provider in .env; the documented examples include OpenAI, Anthropic, and Ollama.

How do you use this agent?

Validate a bundled scene with uv run worldseed validate configs/ai_layoffs.yaml, then start it with uv run worldseed play configs/ai_layoffs.yaml. Open http://localhost:8000 and choose Watch to observe, Intervene to privately message an agent, or Play to enter a character. For a new world, use /create-world "your world description", or author YAML directly, then validate and launch it with uv run worldseed validate configs/my_scene.yaml and uv run worldseed play configs/my_scene.yaml.

What are this agent's strengths and limitations?

Pros
  • YAML declares characters, rules, private information, and perception filters, while the engine has no hardcoded domain knowledge.
  • It separates deterministic DSL resolution from uncertain LLM judgment, with the Dungeon Master returning structured effects rather than free-form prose.
  • Character-specific perception filtering directly supports secrets, conflicting beliefs, intelligence work, and social simulation.
  • The local dashboard combines observation, private intervention, role-play, and replayable run history.
Limitations
  • The documented setup requires Python 3.11+, Node.js 18+, uv, and an npm frontend build.
  • A LiteLLM provider configuration and credentials are required; Dungeon Master outcomes depend on the selected model.
  • Creating robust worlds requires maintaining YAML scene and UI configuration, perception rules, and DSL rules.
  • The documented path is local startup; production deployment, hosted operation, and cost controls are not specified.

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
WorldSeed This agent 56 · Major gaps CLIFree + model costs ★ 824 6mo ago Python Codex · OpenAI API · Claude API
MassGen 50 · Major gaps CLIFree + model costs ★ 1.1k 4mo ago Python Codex · Claude Code · OpenAI API · Claude API
KADATH 66 · Some gaps CLIFree + model costs ★ 228 15d ago Python OpenAI API
IR-SIM: Lightweight Robot Simulator 57 · Major gaps Library / SDKFree ★ 1.2k 7d ago Python —

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
56/ 100 5-point scale 2.8 / 5
Trust 12/29
Reliability 8/14
Adaptability 14/18
Convention 11/18
Effectiveness 7/13
Verifiability 4/8
Why each dimension lost points
Trust12 / 29 · 2.1/5

The evidence shows role-filtered perception and a replayable event stream. The dedicated autoresearch runtime exposes only perceive/act tools and delegates filesystem work to the engine. The OpenClaw guide, however, allows agents to use their own file, shell, web, and other tools, so least privilege depends on the external runtime. Agents are encouraged to act autonomously; user confirmation is mainly available through optional intervention. Logs, pause/resume, and run records improve data-flow visibility, but retention, credential protection, and handling by external services are not fully described. Dependencies have version ranges but no security audit evidence is shown. Pause, stop, resume, and snapshots provide some recovery. The license and copyright holder are stated, but publisher identity is unverified and maintenance ownership or update path is unclear.

Reliability8 / 14 · 2.9/5

The protocol, architecture notes, and server code broadly agree on perception, action submission, and tick lifecycle. The sample describes OpenClaw, Codex, and a dedicated autoresearch runtime, so it does not establish that every execution path is fully consistent. The README lists Python, Node, uv, and LiteLLM prerequisites and setup steps, but broad version ranges and external model services leave availability dependent on outside components. The skill says failed actions return reasons and actual values, and the docs give health checks, state queries, and troubleshooting steps; the sample does not establish consistent handling across all error paths.

Adaptability14 / 18 · 3.9/5

The materials explicitly target multi-agent simulations, production collaboration, games, and fictional worlds, with research, tool-pilot, layoffs, and espionage examples. Capability boundaries are described: WorldSeed manages shared state, visibility, and consequences, while agents' own tools do the work. Yet OpenClaw tools can be broad, so the boundary depends on configuration. Wake frequency, available actions, valid targets, and optional intervention are documented, while exact triggers largely depend on the scene and external runtime. Setup guides cover a local server, dashboard, OpenClaw, and Codex workflows, though the environment has several prerequisites and the sample does not cover every configuration.

Convention11 / 18 · 3.1/5

Documentation is organized into getting started, architecture, scene configuration, runtime adapters, and development guides, including Chinese and English material. Setup instructions cover dependencies, commands, model credentials, and budget controls, but do not fully cover every deployment path. Names such as WorldSeed, worldseed, and Codex runner are mostly stable across the sample. There are numerous examples and troubleshooting steps, but no standalone FAQ or exhaustive common-failure guide. Some limitations, such as slow or offline agents and budget controls, are mentioned without a systematic limitations list. The repository includes the full MIT license text. The project version is 0.1.0, but no changelog appears in the sample. AIScientists Inc. is named as copyright holder, while maintenance responsibility, support commitments, and update process are unclear.

Effectiveness7 / 13 · 2.7/5

The product combines YAML scenes, role-specific perception, action rules, a dashboard, and run records to make multi-agent activity observable and replayable. The research example claims papers, experiments, and an evolution graph, but a static review cannot verify those outcomes. Information asymmetry, shared coordination state, and consequences provide a clear potential gain over using agents alone; the gain depends on scene design and external agent capability. Operation requires Python, Node, and a model service or runtime; research scenes may also consume GPU time and model credits. Budget controls are documented, but general cost estimates are not, limiting cost-benefit evidence.

Verifiability4 / 8 · 2.5/5

Core architecture claims can be traced across the README, runtime docs, protocol structures, and server code, including perception data, action options, and event logging. This supports ordinary traceability and cross-source corroboration. Some demo metrics and experiment results appear only as project claims in the README and cannot be independently verified from this static sample. Test commands are documented but were not run. The materials distinguish system mechanics from demo narrative in places, but do not consistently label evidence for each result, so fact and inference separation remains limited.

Risks and how to mitigate them
  • OpenClaw agents may use their own file, shell, web, and other tools; effective permissions and external effects depend on runtime and scene configuration.
  • Configuring model credentials and running a scene can call external model services. Autoresearch may also run long experiments and consume GPU resources. Budget controls are documented, but general cost estimates are not.
  • Demo metrics are repository claims; this static review did not execute the code or independently verify results.
Evidence confidence: Low Reviewed Nov 08, 2026 Reviewed revision 4ffeabfdee6d
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/worldseed.svg)](https://followagents.com/en/agents/worldseed)
<a href="https://followagents.com/en/agents/worldseed"><img src="https://followagents.com/badge/worldseed.svg" alt="FARS review"></a>

FAQ

Is it tied to one model provider?
No. The Dungeon Master is described as compatible with any LiteLLM-supported model; documented examples include OpenAI, Anthropic, and Ollama.
Which actions are deterministic?
Predictable actions are resolved by the YAML DSL. Uncertain actions are judged by the LLM Dungeon Master and returned as structured effects.
What can an operator do during a run?
At the local dashboard, an operator can watch characters and their inner state, privately intervene with an agent, or play as a character.
What does it cost to run?
A LiteLLM provider API key is required, but the repository does not specify call volume, pricing, or budget-control features.
Was this page helpful?
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.