MiroFish

A simple and universal swarm intelligence engine that generates thousands of AI agents, drops them into a virtual world, and watches them predict the future.

View on GitHub Documentation
28K+
GitHub Stars
3.4K
Forks
$4M
Funding (24hrs)
#1
GitHub Trending

How It Works

01

Feed It a Document

Upload any text — a news article, policy paper, market report, or research paper. MiroFish extracts every entity, relationship, and idea using GraphRAG.

02

Generate AI Agents

Thousands of autonomous agents are created, each with their own personality, beliefs, emotional state, MBTI type, and behavioral patterns derived from the document.

03

Simulate the World

Agents interact on a simulated social platform — posting, reacting, debating. Inject variables ("pass this law") and watch the entire society respond in real time.

04

Predict the Future

Analyze the simulation results, interview focus groups of agents, and generate structured prediction reports with evidence from the knowledge graph.

Use Cases

🗳️

Election Prediction

Simulate voter populations reacting to campaign events, debates, and policy announcements.

📈

Market Analysis

Model how consumers react to product launches, pricing changes, or competitor moves.

📰

Media & PR

Predict public sentiment before a press release drops. Test messaging with simulated audiences.

⚖️

Policy Impact

Test how new laws or regulations affect different population segments before implementation.

🌍

Geopolitical Modeling

Simulate international relations, treaty impacts, and conflict scenarios with nation-state agents.

🔬

Academic Research

Run social science experiments at scale without real human subjects. Test hypotheses instantly.

Tech Stack

Python GraphRAG Zep Cloud (Memory) OASIS Framework OpenAI / Qwen LLM Neo4j (Knowledge Graph) Flask Backend React Frontend
Document → Text Processing → GraphRAG Entity Extraction ↓ Knowledge Graph (Zep Cloud) ↓ Entity → Agent Profile Generator (LLM-powered) ↓ OASIS Social Simulation Platform ├── Twitter-style interactions └── Reddit-style discussions ↓ Report Agent (analyzes simulation + interviews agents) ↓ Structured Prediction Report
Guo Hangjiang

Guo Hangjiang (BaiFu)

20-year-old senior at Beijing University of Posts and Telecommunications. Previously built BettaFish, a multi-agent public opinion analysis tool that hit #1 on GitHub trending with 20,000 stars in one week.

$4,000,000

Raised from Chen Tianqiao (Shanda Group) within 24 hours of launch

30 million yuan investment — before the project even had a demo video