{"id":46344734,"url":"https://github.com/666ghj/mirofish","last_synced_at":"2026-03-07T15:03:56.069Z","repository":{"id":329936804,"uuid":"1104332987","full_name":"666ghj/MiroFish","owner":"666ghj","description":"A Simple and Universal Swarm Intelligence Engine, Predicting Anything. 简洁通用的群体智能引擎，预测万物","archived":false,"fork":false,"pushed_at":"2026-02-27T09:29:49.000Z","size":15606,"stargazers_count":4371,"open_issues_count":34,"forks_count":540,"subscribers_count":42,"default_branch":"main","last_synced_at":"2026-03-05T01:34:26.860Z","etag":null,"topics":["agent-memory","financial-forecasting","future-prediction","knowledge-graph","llms","multi-agent-simulation","public-opinion-analysis","python3","social-prediction","swarm-intelligence"],"latest_commit_sha":null,"homepage":"https://666ghj.github.io/mirofish-demo/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/666ghj.png","metadata":{"files":{"readme":"README-EN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-26T04:23:02.000Z","updated_at":"2026-03-04T23:09:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/666ghj/MiroFish","commit_stats":null,"previous_names":["666ghj/mirofish"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/666ghj/MiroFish","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666ghj%2FMiroFish","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666ghj%2FMiroFish/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666ghj%2FMiroFish/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666ghj%2FMiroFish/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/666ghj","download_url":"https://codeload.github.com/666ghj/MiroFish/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666ghj%2FMiroFish/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30219315,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T14:02:48.375Z","status":"ssl_error","status_checked_at":"2026-03-07T14:02:43.192Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-memory","financial-forecasting","future-prediction","knowledge-graph","llms","multi-agent-simulation","public-opinion-analysis","python3","social-prediction","swarm-intelligence"],"created_at":"2026-03-04T21:08:46.159Z","updated_at":"2026-03-07T15:03:56.060Z","avatar_url":"https://github.com/666ghj.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./static/image/MiroFish_logo_compressed.jpeg\" alt=\"MiroFish Logo\" width=\"75%\"/\u003e\n\n\u003ca href=\"https://trendshift.io/repositories/16144\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/16144\" alt=\"666ghj%2FMiroFish | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n\n简洁通用的群体智能引擎，预测万物\n\u003c/br\u003e\n\u003cem\u003eA Simple and Universal Swarm Intelligence Engine, Predicting Anything\u003c/em\u003e\n\n\u003ca href=\"https://www.shanda.com/\" target=\"_blank\"\u003e\u003cimg src=\"./static/image/shanda_logo.png\" alt=\"666ghj%2MiroFish | Shanda\" height=\"40\"/\u003e\u003c/a\u003e\n\n[![GitHub Stars](https://img.shields.io/github/stars/666ghj/MiroFish?style=flat-square\u0026color=DAA520)](https://github.com/666ghj/MiroFish/stargazers)\n[![GitHub Watchers](https://img.shields.io/github/watchers/666ghj/MiroFish?style=flat-square)](https://github.com/666ghj/MiroFish/watchers)\n[![GitHub Forks](https://img.shields.io/github/forks/666ghj/MiroFish?style=flat-square)](https://github.com/666ghj/MiroFish/network)\n[![Docker](https://img.shields.io/badge/Docker-Build-2496ED?style=flat-square\u0026logo=docker\u0026logoColor=white)](https://hub.docker.com/)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/666ghj/MiroFish)\n\n[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square\u0026logo=discord\u0026logoColor=white)](https://discord.com/channels/1469200078932545606/1469201282077163739)\n[![X](https://img.shields.io/badge/X-Follow-000000?style=flat-square\u0026logo=x\u0026logoColor=white)](https://x.com/mirofish_ai)\n[![Instagram](https://img.shields.io/badge/Instagram-Follow-E4405F?style=flat-square\u0026logo=instagram\u0026logoColor=white)](https://www.instagram.com/mirofish_ai/)\n\n[English](./README-EN.md) | [中文文档](./README.md)\n\n\u003c/div\u003e\n\n## ⚡ Overview\n\n**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**.\n\n\u003e You only need to: Upload seed materials (data analysis reports or interesting novel stories) and describe your prediction requirements in natural language\u003c/br\u003e\n\u003e MiroFish will return: A detailed prediction report and a deeply interactive high-fidelity digital world\n\n### Our Vision\n\nMiroFish 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:\n\n- **At the Macro Level**: We are a rehearsal laboratory for decision-makers, allowing policies and public relations to be tested at zero risk\n- **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\n\nFrom serious predictions to playful simulations, we let every \"what if\" see its outcome, making it possible to predict anything.\n\n## 🌐 Live Demo\n\nWelcome to visit our online demo environment and experience a prediction simulation on trending public opinion events we've prepared for you: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"./static/image/Screenshot/运行截图1.png\" alt=\"Screenshot 1\" width=\"100%\"/\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"./static/image/Screenshot/运行截图2.png\" alt=\"Screenshot 2\" width=\"100%\"/\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"./static/image/Screenshot/运行截图3.png\" alt=\"Screenshot 3\" width=\"100%\"/\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"./static/image/Screenshot/运行截图4.png\" alt=\"Screenshot 4\" width=\"100%\"/\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"./static/image/Screenshot/运行截图5.png\" alt=\"Screenshot 5\" width=\"100%\"/\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"./static/image/Screenshot/运行截图6.png\" alt=\"Screenshot 6\" width=\"100%\"/\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\n## 🎬 Demo Videos\n\n### 1. Wuhan University Public Opinion Simulation + MiroFish Project Introduction\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.bilibili.com/video/BV1VYBsBHEMY/\" target=\"_blank\"\u003e\u003cimg src=\"./static/image/武大模拟演示封面.png\" alt=\"MiroFish Demo Video\" width=\"75%\"/\u003e\u003c/a\u003e\n\nClick the image to watch the complete demo video for prediction using BettaFish-generated \"Wuhan University Public Opinion Report\"\n\u003c/div\u003e\n\n### 2. Dream of the Red Chamber Lost Ending Simulation\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.bilibili.com/video/BV1cPk3BBExq\" target=\"_blank\"\u003e\u003cimg src=\"./static/image/红楼梦模拟推演封面.jpg\" alt=\"MiroFish Demo Video\" width=\"75%\"/\u003e\u003c/a\u003e\n\nClick the image to watch MiroFish's deep prediction of the lost ending based on hundreds of thousands of words from the first 80 chapters of \"Dream of the Red Chamber\"\n\u003c/div\u003e\n\n\u003e **Financial Prediction**, **Political News Prediction** and more examples coming soon...\n\n## 🔄 Workflow\n\n1. **Graph Building**: Seed extraction \u0026 Individual/collective memory injection \u0026 GraphRAG construction\n2. **Environment Setup**: Entity relationship extraction \u0026 Persona generation \u0026 Agent configuration injection\n3. **Simulation**: Dual-platform parallel simulation \u0026 Auto-parse prediction requirements \u0026 Dynamic temporal memory updates\n4. **Report Generation**: ReportAgent with rich toolset for deep interaction with post-simulation environment\n5. **Deep Interaction**: Chat with any agent in the simulated world \u0026 Interact with ReportAgent\n\n## 🚀 Quick Start\n\n### Option 1: Source Code Deployment (Recommended)\n\n#### Prerequisites\n\n| Tool | Version | Description | Check Installation |\n|------|---------|-------------|-------------------|\n| **Node.js** | 18+ | Frontend runtime, includes npm | `node -v` |\n| **Python** | ≥3.11, ≤3.12 | Backend runtime | `python --version` |\n| **uv** | Latest | Python package manager | `uv --version` |\n\n#### 1. Configure Environment Variables\n\n```bash\n# Copy the example configuration file\ncp .env.example .env\n\n# Edit the .env file and fill in the required API keys\n```\n\n**Required Environment Variables:**\n\n```env\n# LLM API Configuration (supports any LLM API with OpenAI SDK format)\n# Recommended: Alibaba Qwen-plus model via Bailian Platform: https://bailian.console.aliyun.com/\n# High consumption, try simulations with fewer than 40 rounds first\nLLM_API_KEY=your_api_key\nLLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1\nLLM_MODEL_NAME=qwen-plus\n\n# Zep Cloud Configuration\n# Free monthly quota is sufficient for simple usage: https://app.getzep.com/\nZEP_API_KEY=your_zep_api_key\n```\n\n#### 2. Install Dependencies\n\n```bash\n# One-click installation of all dependencies (root + frontend + backend)\nnpm run setup:all\n```\n\nOr install step by step:\n\n```bash\n# Install Node dependencies (root + frontend)\nnpm run setup\n\n# Install Python dependencies (backend, auto-creates virtual environment)\nnpm run setup:backend\n```\n\n#### 3. Start Services\n\n```bash\n# Start both frontend and backend (run from project root)\nnpm run dev\n```\n\n**Service URLs:**\n- Frontend: `http://localhost:3000`\n- Backend API: `http://localhost:5001`\n\n**Start Individually:**\n\n```bash\nnpm run backend   # Start backend only\nnpm run frontend  # Start frontend only\n```\n\n### Option 2: Docker Deployment\n\n```bash\n# 1. Configure environment variables (same as source deployment)\ncp .env.example .env\n\n# 2. Pull image and start\ndocker compose up -d\n```\n\nReads `.env` from root directory by default, maps ports `3000 (frontend) / 5001 (backend)`\n\n\u003e Mirror address for faster pulling is provided as comments in `docker-compose.yml`, replace if needed.\n\n## 📬 Join the Conversation\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./static/image/QQ群.png\" alt=\"QQ Group\" width=\"60%\"/\u003e\n\u003c/div\u003e\n\n\u0026nbsp;\n\nThe MiroFish team is recruiting full-time/internship positions. If you're interested in multi-agent simulation and LLM applications, feel free to send your resume to: **mirofish@shanda.com**\n\n## 📄 Acknowledgments\n\n**MiroFish has received strategic support and incubation from Shanda Group!**\n\nMiroFish's simulation engine is powered by **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)**, We sincerely thank the CAMEL-AI team for their open-source contributions!\n\n## 📈 Project Statistics\n\n\u003ca href=\"https://www.star-history.com/#666ghj/MiroFish\u0026type=date\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=666ghj/MiroFish\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=666ghj/MiroFish\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=666ghj/MiroFish\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F666ghj%2Fmirofish","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F666ghj%2Fmirofish","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F666ghj%2Fmirofish/lists"}