A Simple and Universal Swarm Intelligence Engine, Predicting Anything

English | 中文文档

MiroFish is a next-generation AI prediction engine powered by multi-agent technology. By extracting seed information from the real world (such as breaking news, policy drafts, or financial signals), it automatically constructs a high-fidelity parallel digital world. Within this space, thousands of intelligent agents with independent personalities, long-term memory, and behavioral logic freely interact and undergo social evolution. You can inject variables dynamically from a "God's-eye view" to precisely deduce future trajectories — rehearse the future in a digital sandbox, and win decisions after countless simulations.

You only need to: Upload seed materials (data analysis reports or interesting novel stories) and describe your prediction requirements in natural language
MiroFish will return: A detailed prediction report and a deeply interactive high-fidelity digital world

MiroFish is dedicated to creating a swarm intelligence mirror that maps reality. By capturing the collective emergence triggered by individual interactions, we break through the limitations of traditional prediction:

• At the Macro Level: We are a rehearsal laboratory for decision-makers, allowing policies and public relations to be tested at zero risk
• At the Micro Level: We are a creative sandbox for individual users — whether deducing novel endings or exploring imaginative scenarios, everything can be fun, playful, and accessible

From serious predictions to playful simulations, we let every "what if" see its outcome, making it possible to predict anything.

Click the image to watch the complete demo video for prediction using BettaFish-generated Wuhan University Public Opinion Report

More demo videos coming soon: "Dream of the Red Chamber" ending simulation, financial prediction examples...

1. Graph Construction: Real-world seed extraction & Individual and collective memory injection & GraphRAG construction
2. Environment Setup: Entity relationship extraction & Persona generation & Agent configuration with simulation parameters
3. Start Simulation: Dual-platform parallel simulation & Automatic prediction requirement parsing & Dynamic temporal memory updates
4. Report Generation: ReportAgent with rich toolset for deep interaction with post-simulation environment
5. Deep Interaction: Chat with any agent in the simulated world & Interact with ReportAgent

Note: MiroFish was developed and tested on Mac. Windows compatibility is unknown and currently under testing.

# Copy the example configuration file
cp .env.example .env

# Edit the .env file and fill in the required API keys

Required Environment Variables:

# LLM API Configuration (supports any LLM with OpenAI SDK format)
# Recommended: Alibaba Bailian Platform qwen-plus model: https://bailian.console.aliyun.com/
# Note: High consumption, try simulations with fewer than 40 rounds first
LLM_API_KEY=your_api_key
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL_NAME=qwen-plus

# Zep Cloud Configuration
# Free monthly quota is sufficient for simple usage: https://app.getzep.com/
ZEP_API_KEY=your_zep_api_key

# One-click installation of all dependencies (root + frontend + backend)
npm run setup:all

Or install step by step:

# Install Node dependencies (root + frontend)
npm run setup

# Install Python dependencies (auto-creates virtual environment)
npm run setup:backend

# Start both frontend and backend (run from project root)
npm run dev

Service URLs:

• Frontend: http://localhost:3000
• Backend API: http://localhost:5001

Start Individually:

npm run backend   # Start backend only
npm run frontend  # Start frontend only

MiroFish has received strategic support and incubation from Shanda Group!

MiroFish's core simulation engine is powered by OASIS. OASIS is a high-performance social media simulation framework developed by the CAMEL-AI team, supporting million-scale agent interaction simulations, providing a solid technical foundation for MiroFish's swarm intelligence emergence. We sincerely thank the CAMEL-AI team for their open-source contributions!