TrendWhat rose on GitHub, every day at 07:30 KST · 한국어

GitHub · as of November 8, 2026 · View on GitHub →

666ghj/MiroFish

Multi-agent prediction simulation engine

+1,634 stars in 7 days

Simulate future scenarios by seeding thousands of AI agents with news or fiction

Upload an interesting news article or novel manuscript, and thousands of artificial intelligences inhabit it, conversing and acting with one another. This process resembles a laboratory that reproduces real-world social interactions in a digital space. When you inject a desired scenario, the system returns the resulting future trends in a reporting format.

Prediction experiments starting with seed data

This tool builds a virtual world based on provided information. When a user uploads 'seed' materials such as news or reports and describes the prediction target in natural language, the system generates agents with independent personalities and memories. These agents interact with each other, undergo social evolution, and infer future trajectories in the process. Users can inject variables from a 'god's eye' perspective to simulate how specific outcomes change.

Graph-based memory and agent composition

Internally, the system extracts individual and group memories from seed information and organizes them into a graph structure. Based on this graph, it sets the personality and behavior logic for each agent, completing the environment through relationship extraction. As the simulation progresses, memories are updated over time, and simulations run in parallel on two platforms. In the final stage, a report agent equipped with a toolset interacts with the post-simulation environment to generate a detailed report.

Installation and execution environment

Source code distribution is recommended, requiring Node.js 18 or higher, Python 3.11 to 3.12, and the uv packaging manager. You must enter LLM API keys and Zep Cloud API keys in the environment variable file, and you can use LLM APIs that support the OpenAI SDK format. The official documentation recommends the Alibaba Qwen-plus model and advises trying simulations of fewer than 40 rounds for initial testing. Dependency installation and service execution are handled by the npm run setup:all and npm run dev commands, with the frontend running on port 3000 and the backend on port 5001.

Costs and limitations to check before use

Because this tool performs large-scale agent simulations, LLM API usage can be significant. The README explicitly states to reduce the number of rounds for testing in the initial stages, indicating that a gradual approach is needed rather than unlimited experimentation. It also mentions that Zep Cloud's free allocation is sufficient for simple use, suggesting that additional cost burdens may be low in the early stages. Currently, the demo focuses on public opinion simulation and novel ending prediction, while financial or political news prediction is noted as planned for future updates.

Written by AI from this repository's README on September 26, 2026. For the facts, the original on GitHub is the reference.

By the numbers

GitHub trending history
2 days between Jun 19, when Trend began recording, and Nov 8, 2026 · first on Aug 7 · best daily rank #5 (Sep 14)

Read from GitHub, as of November 8, 2026.

Language
Python
Topics
agent-memory · financial-forecasting · future-prediction · knowledge-graph · llms · multi-agent-simulation · public-opinion-analysis · python3
Stars
84,855
Stars gained in 7 days
+1,634
Contributors
19
Forks
12,860
Latest release
v0.1.2 · March 7, 2026
Commits
322
Last commit
October 1, 2026
Open issues
93
Open pull requests
149

View on GitHub → · Homepage

README badge

trend.ondo.sh · GitHub daily trending #5 · September 14, 2026

The badge above shows the highest this repository has ranked on GitHub's daily trending since June 19, 2026, and the day it did. Paste the Markdown below into your README. The badge opens this page, and it updates by itself when the repository climbs higher.

[![trend.ondo.sh](https://trend.ondo.sh/github/r/666ghj--MiroFish/badge.en.svg)](https://trend.ondo.sh/github/r/666ghj--MiroFish/en.html)