Thanks to visit codestin.com
Credit goes to github.com

Skip to content
BranchesTags

Latest commit

 

History

629 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
.x402books
.x402books
 
 
backend
backend
 
 
docs
docs
 
 
frontend
frontend
 
 
scripts
scripts
 
 
.dockerignore
.dockerignore
 
 
.env.example
.env.example
 
 
.gitignore
.gitignore
 
 
CLAUDE.md
CLAUDE.md
 
 
Dockerfile
Dockerfile
 
 
Dockerfile.railway
Dockerfile.railway
 
 
ECOSYSTEM.md
ECOSYSTEM.md
 
 
LICENSE
LICENSE
 
 
README_DEPLOYMENT.md
README_DEPLOYMENT.md
 
 
cloudbuild.yaml
cloudbuild.yaml
 
 
cloudrun.env.yaml.example
cloudrun.env.yaml.example
 
 
docker-compose.ollama.yml
docker-compose.ollama.yml
 
 
docker-compose.traefik.yml
docker-compose.traefik.yml
 
 
docker-compose.yml
docker-compose.yml
 
 
miroshark
miroshark
 
 
miroshark-nobg.png
miroshark-nobg.png
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
railway.env.example
railway.env.example
 
 
railway.json
railway.json
 
 
render.yaml
render.yaml
 
 

Repository files navigation

MiroShark — Simulate anything for $1 in under 10 minutes with 100+ grounded agents. The pipeline flows input → build world → swarm → report. Keywords: multi-agent simulation, social simulation, swarm intelligence, agent-based modeling, LLM agents, prediction market, scenario testing.

Simulate anything.

Star us ❤️ →   Star MiroShark on GitHub   miroshark.xyz   MiroShark docs   @miroshark_ on X   $miroshark on Bankr

$1 · per simulation  ·  10 min · first result  ·  100+ · grounded agents

Grounded · real personas  ·  Cross-platform · X, Reddit, markets  ·  Cited · real posts & trades

stars forks license python node

English · 中文 · 日本語 · Français


MiroShark live demo — a user drops in a document, MiroShark builds the world graph, spawns 100+ agents, and they post, argue, and trade in real time while a report is written.



What it does

What MiroShark does, in four steps: (1) You bring a scenario — MiroShark builds the world around it. (2) Hundreds of grounded agents across Twitter, Reddit, and a prediction market, hour by hour. (3) Chat with any agent, drop breaking news mid-run, fork the timeline. (4) Get a report on what happened, citing actual posts and trades.


Get started

git clone https://github.com/aaronjmars/MiroShark.git && cd MiroShark
cp .env.example .env    # paste one OpenRouter key
./miroshark             # deps + Neo4j + servers → http://localhost:3000

Full install — cloud, Docker, Ollama, Claude Code



How it works

MiroShark overview — information propagates through X (Twitter), herd effects form in Reddit and Polymarket, 100+ agent personas across 3 platforms drive cross-platform dynamics, and a ReAct report agent writes the recap. Five workflow steps.

MiroShark five-phase pipeline: Phase 1 Ontology Generation, Phase 2 Graph Building, Phase 3 Agent Setup, Phase 4 Simulation Execution, Phase 5 Report and Interaction.



Grounded agents

Not roleplay. Every agent is grounded in five layers of real context.

Five layers of grounding per MiroShark agent: demographic seed, web enrichment, semantic search, relationships, and graph attributes.



What can you simulate?

PR crisis testing — simulate public reaction to a press release before publishing.

Market reaction — feed financial news and observe simulated trader and investor sentiment on a live prediction market.

Advertising — test a campaign, headline, or pitch against a simulated audience before spending.

Policy analysis — test draft regulations against a simulated public.

What-if history — rewrite a historical event and see how a population of personas re-narrates the aftermath.

Creative experiments — feed a novel with a lost ending; agents write a narratively consistent conclusion.



Features

MiroShark marquee features: Smart Setup (doc → 3 Bull/Bear/Neutral scenarios in 2s), Just Ask (question with no doc → researched seed briefing), Counterfactual Branching (fork a running sim with an injected event), Director Mode (inject breaking news into the current timeline), Per-Agent MCP Tools (agents call real web search and APIs), Article Generation (Substack-style grounded write-up), Public Gallery and Verified Predictions, Share Everywhere (cards, replay GIFs, tweet threads, RSS, embeds, Slack/Discord/Telegram/webhooks).

40+ features · full list and deep dives →



Docs

Install  Configuration  Models  Architecture

HTTP API  CLI  MCP  Webhooks  Ecosystem



Community

Follow @miroshark_ on X for launches, demos, and updates. Read the MiroShark documentation. $miroshark token on Bankr.



We love contributors

We love contributors — every bug fix, new agent, and doc tweak makes MiroShark better. Big PRs and small ones, both welcome.

We're excited to meet you.
Every bug fix, new agent, or doc tweak makes MiroShark better. Big PRs and small ones, both welcome.

📝 Contributing guide  ·  💬 Say hi on X



AGPL-3.0 · Support the project: 0xd7bc6a05a56655fb2052f742b012d1dfd66e1ba3 🦈

Built by Aaron Elijah Mars, founder of Aeon and MiroShark · @aaronjmars

About

Simulate anything, for $1 & less than 10 min - Universal Swarm Intelligence Engine

www.miroshark.xyz

Topics

ai-simulationfinancial-forecastingfuture-predictionmirofishswarmswarm-intelligence

Resources

Readme
AGPL-3.0 license

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

1.4k stars

Watchers

5 watching

Forks

299 forks
Report repository

Releases

Sponsor this project

Packages

Used by

Contributors

Languages