Open-source Python-based AI agent workflow cultivation world simulator with FastAPI frontend, Docker deployment, and multi-language UI. Latest releases include v4.0.1 (2026-08-02) and v4.0.0 (2026-08-01).
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Based on AI Agent workflows, this repository provides a Cultivation World Simulator where each cultivator is an independent Agent driven by LLMs and rules to create emergent narratives in a world with sects, zones, events, and items. The project emphasizes agentic workflows and world-building rules to constrain AI behavior.
How it works
The system models a world with maps, time, and events, with NPCs and factions interacting under a rule-based framework and AI-driven decision-making. It includes modules for world state, entities (sects, cities, regions), events, and AI-enhanced decision making. It supports both a desktop experience and programmatic access via an external API. The AI drives NPCs, narratives, and outcomes within defined game mechanics.
Getting started
Recommended approaches
- For code modification or debugging: deploy from source with dependencies and local model services.
- For direct experience: Epic Games Store desktop version, or Docker deployment.
First run guidance from README
- For Epic desktop: ensure model configuration in settings after launching.
- For source or Docker: configure model presets (e.g., DeepSeek / MiniMax / Ollama) in settings before starting a new game. This configuration is saved to the user data directory.
First-time startup (source/development)
- Install dependencies and start:
# 1. Install backend dependencies
pip install -r requirements.txt
# 2. Install frontend dependencies (Node.js required)
cd web && npm install && cd ..
# 3. Start service (auto-launches frontend/backend)
python src/server/main.py --dev
Accessing frontend
The frontend is typically served at http://localhost:5173 when in development mode.
Getting started with Docker
git clone https://github.com/4thfever/cultivation-world-simulator.git
cd cultivation-world-simulator
docker-compose up -d --build
Visit frontend at http://localhost:8123. Backend data is persisted under the docker data directory, defaulting to ./docker-data.
Recent releases
- v4.0.1 v4.0.1 (2026-08-02): Full Changelog: https://github.com/4thfever/cultivation-world-simulator/compare/v4.0.0...v4.0.1
- v4.0.0 v4.0.0 (2026-08-01): fix: 修复wls中docker容器中unhealthy问题 by @hhzscreate in https://github.com/4thfever/cultivation-world-simulator/pull/208
- v3.9 v3.9 (2026-07-19): Full Changelog: https://github.com/4thfever/cultivation-world-simulator/compare/v3.8.0...v3.9
- v3.8.0 v3.8.0 (2026-07-11): ## What's Changed feat: rebuild world lore rewrite pipeline by @4thfever
- v3.7.0 v3.7.0 (2026-07-03): ...
Traction
Stars: 1999 (data point provided; no further interpretation)
Behind the repo
Not provided in the facts.
Caveats
- Language: README content in Chinese; project description includes multilingual elements in README excerpts, but the facts provided show no license listed.
- License: none listed
- Created: 2025-08-18
- Last push: 2026-08-03