MiroFish

Active
GitHub Python AGPL-3.0

Description

Multi-agent swarm intelligence engine that extracts seed information from the real world, constructs a high-fidelity parallel digital world with thousands of agents, and predicts future trajectories through social evolution simulations.

Key Features

  • Multi-agent swarm simulation — thousands of agents with independent personalities and long-term memory freely interact
  • GraphRAG knowledge graph — automatically constructs a high-fidelity parallel digital world from seed materials
  • Dynamic memory — continuously updates individual and collective memory during simulation
  • Dual-platform parallel — runs simulations on multiple platforms simultaneously for stable predictions
  • ReportAgent toolset — deeply interacts with the simulated environment to generate detailed prediction reports
  • Free interaction — chat with any agent in the simulated world to explore details

Use Cases

💡 Policy simulation and PR rehearsal — testing policies and PR strategies in zero-risk environments
💡 Financial market forecasting — predicting stock prices and public opinion trends from event signals
💡 Public opinion evolution analysis — simulating how viewpoints spread and collide on social media
💡 Creative narrative continuation — writing novel endings and exploring alternate fictional outcomes
💡 Strategic decision sandbox — enterprises running multi-round simulations before major events to optimize decisions

Strengths & Limitations

Strengths

  • Actively maintained, recent updates
  • High community interest (71.9k stars)
  • Responsive to issues, low backlog

⚠️ Limitations

  • Restrictive license (AGPL-3.0)

Quick Start

git clone https://github.com/666ghj/MiroFish.git
cd MiroFish
cp .env.example .env  # fill in LLM API keys
uv sync
uv run python main.py

Related Projects

PraisonAI

9.0k · Python
Active A+

PraisonAI is a low-code multi-agent framework with handoffs, guardrails, memory, RAG, and 100+ LLM providers, deployable to Telegram, Discord, and WhatsApp.

multi-agentagent-frameworkmcp +3
  • · Low-code multi-agent framework with agent handoffs, guardrails, memory, and RAG capabilities
  • · 100+ LLM provider support including OpenAI, Anthropic, Gemini, Ollama, and local models
  • · Multiple deployment interfaces: Core SDK, CLI, Claw Dashboard, Flow Visual Builder, and UI

AgentVerse

5.1k · JavaScript
Stale C

AgentVerse is a multi-agent deployment framework by Tsinghua OpenBMB, offering task-solving and simulation paradigms for collaborative multi-LLM-agent systems.

multi-agentllmsimulation +1
  • · Dual framework support for task-solving (multi-agent collaboration) and simulation (environment observation)
  • · Configurable agent definitions via YAML with role, tool, and environment customization
  • · Built-in recruiter component for dynamically assembling agent teams based on task requirements

NagaAgent

1.5k · Python
Active A

A simple yet powerful agent framework for personal assistants, designed to enable intelligent interaction, multi-agent collaboration, and seamless tool integration with built-in memory and tree-of-thought reasoning.

multi-agentframeworkpython +2
  • · Anime-styled AI assistant with Live2D avatar, voice interaction, and streaming tool calls
  • · Knowledge graph memory system with 3D visualization and GRAG memory management
  • · Built-in OpenClaw integration for exploring knowledge domains and autonomous task execution