WorldX  by YGYOOO

AI world simulation and emergent narrative engine

Created 1 week ago

New!

387 stars

Top 73.7% on SourcePulse

GitHubView on GitHub
Project Summary

WorldX generates dynamic, AI-driven virtual worlds from single text prompts, featuring autonomous agents with emergent behaviors and narratives. It targets developers and creators interested in AI simulation and procedural content, offering a novel platform for rapid prototyping and interactive storytelling.

How It Works

A multi-LLM architecture orchestrates world creation, procedural asset generation (maps, characters), and agent simulation. Agents possess memory and personality, making decisions and interacting within the environment. Users can act as "gods," intervening via events or character edits, observing emergent narratives and multi-day evolutions. The system supports parallel timelines and bilingual operation.

Quick Start & Requirements

  • Install: git clone, cd WorldX, cp .env.example .env, npm install, npm run dev.
  • Prerequisites: Node.js 18+. Requires API keys for LLM providers (OpenAI compatible) for four roles: Orchestrator, Image Generator, Vision, and Simulation. Configure these in .env.
  • Run: Access http://localhost:3200. Choose between pre-generated worlds (simpler setup) or full creation from a prompt.
  • Links: OpenRouter, Google AI Studio.

Highlighted Details

  • One-Sentence World Creation: Instantly generate worlds from descriptive prompts.
  • AI-Generated Assets: Unique maps and character art created procedurally.
  • Autonomous Agents: Agents exhibit independent decision-making, relationships, dialogue, and persistent memory.
  • "God Mode": Intervene by injecting events, editing character states, or direct dialogue.
  • Multi-Day Evolution & Timelines: Worlds evolve over time, supporting parallel narrative branches.
  • Bilingual Support: English and Chinese interfaces.

Maintenance & Community

The README does not specify community channels (e.g., Discord, Slack) or details on contributors and sponsorships.

Licensing & Compatibility

  • License: MIT.
  • Compatibility: Permissive MIT license allows commercial use and integration into closed-source projects.

Limitations & Caveats

The project is in Alpha, undergoing continuous optimization. Users should anticipate ongoing development and potential instability.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
6
Star History
387 stars in the last 11 days

Explore Similar Projects

Feedback? Help us improve.