Skip to content

README-EN.md

Latest commit

 

History

History
158 lines (109 loc) · 5.06 KB

README-EN.md

File metadata and controls

158 lines (109 loc) · 5.06 KB

Azure World

by Mental Wealth Academy

Simulate the future with agentic swarms. Predictive reality from a single document.

Live Demo MWA GitHub

Overview

Azure World is a next-generation multi-agent simulation engine built by Mental Wealth Academy. From a single document — a news article, policy draft, research paper, or novel — it constructs mirrored realities populated by thousands of autonomous agents, each with independent personalities, long-term memory, and behavioral logic.

These agents interact freely, undergo social evolution, and surface emergent dynamics that traditional forecasting cannot capture. You can observe from a god's-eye view, dynamically inject variables, and precisely deduce future trajectories.

Upload a document. Describe your prediction needs in natural language. Azure World returns: a detailed prediction report and a fully interactive high-fidelity digital world.

Vision

Azure World creates a swarm intelligence mirror that maps reality. By capturing collective emergence triggered by individual interactions, it breaks through the limitations of traditional prediction:

  • Macro Level — A rehearsal laboratory for decision-makers. Test policies and strategies at zero risk.
  • Micro Level — A creative sandbox for individuals. Explore "what if" scenarios, from novel endings to geopolitical thought experiments.

From serious predictions to playful simulations — every "what if" gets an answer.

Live Demo

https://azure-world.vercel.app

Static landing page deployed on Vercel (frontend only, no backend required).

Workflow

  1. Graph Building — Real-world seed extraction, individual/collective memory injection, GraphRAG construction
  2. Environment Setup — Entity relationship extraction, persona generation, simulation parameter configuration
  3. Simulation — Dual-platform parallel simulation, auto-parsed prediction requirements, dynamic temporal memory updates
  4. Report Generation — ReportAgent with rich toolset for deep post-simulation interaction
  5. Deep Interaction — Chat with any agent in the simulated world or interact with ReportAgent

Tech Stack

Layer Technology
Frontend Vue 3, Vite, D3.js
Backend Python (Flask), LangChain
Memory Zep Cloud (long-term agent memory)
Graph GraphRAG for entity/relationship extraction
Simulation OASIS engine (multi-agent social simulation)
LLM Any OpenAI-compatible API (configurable)

Quick Start

Prerequisites

Tool Version Check
Node.js 18+ node -v
Python ≥3.11, ≤3.12 python --version
uv Latest uv --version

1. Configure Environment

cp .env.example .env
# Edit .env with your API keys

Required variables:

# LLM API (any OpenAI SDK-compatible endpoint)
LLM_API_KEY=your_api_key
LLM_BASE_URL=https://your-llm-provider/v1
LLM_MODEL_NAME=your-model

# Zep Cloud (free tier at https://app.getzep.com/)
ZEP_API_KEY=your_zep_api_key

2. Install Dependencies

# All at once
npm run setup:all

# Or step by step
npm run setup          # Node dependencies (root + frontend)
npm run setup:backend  # Python dependencies (auto-creates venv)

3. Start Services

npm run dev  # Starts both frontend and backend
Service URL
Frontend http://localhost:3000
Backend API http://localhost:5001 
npm run frontend  # Frontend only
npm run backend   # Backend only

Docker Deployment

cp .env.example .env
docker compose up -d

Maps ports 3000 (frontend) and 5001 (backend).

Project Structure

├── frontend/          # Vue 3 + Vite frontend
│   ├── src/
│   │   ├── views/     # Page components
│   │   ├── components/# Step-by-step simulation UI
│   │   └── assets/    # Images and static assets
│   └── dist/          # Production build
├── backend/           # Python Flask API
│   └── app/
│       ├── api/       # API routes
│       ├── models/    # Data models
│       ├── services/  # Core services
│       └── utils/     # Utilities
└── static/            # Shared static assets

Acknowledgments

  • Simulation engine powered by OASIS (CAMEL-AI)
  • Originally forked from MiroFish by Shanda Group

License

See LICENSE for details.