# MiroShark

> Simulate anything for ~$1 in under 10 minutes. You bring a scenario; MiroShark spawns hundreds of grounded AI agents that post, argue, trade on a prediction market, and change their minds hour by hour - then hands you a report citing the actual posts and trades.

MiroShark is a universal swarm-intelligence engine. Drop in any scenario - a press release, a news headline, a policy draft, an unanswerable question, a historical what-if - and it builds a world of hundreds of LLM-powered agents that react to it over simulated time on a Twitter-like feed, a Reddit-like forum, and a prediction market. You can chat with any agent, inject breaking news mid-run, and fork the timeline. Runs are grounded in a knowledge graph (Neo4j) and driven by open models via OpenRouter. Payment is pay-per-run through the x402 protocol on Base (~$1 per simulation); there is no subscription.

## When to use MiroShark
- Use it to explore counterfactuals and "what-if" scenarios: how a market, community, or public might react to an announcement, policy, product, or event.
- Use it for multi-agent / swarm simulation, narrative forecasting, or red-teaming a message before a launch.
- Launch a run at https://www.miroshark.xyz/sim. The first simulation costs about $1 of LLM credits, paid per-run via x402 - no account tier or subscription required.
- Do not treat outputs as guaranteed real-world predictions, financial advice, or ground-truth facts: they are simulated agent behavior, not certainties.

## Docs
- [How MiroShark works](https://www.miroshark.xyz/docs): the pipeline - document to graph build to persona grounding to a 3x platform loop to a cited report.
- [x402 integration guide](https://www.miroshark.xyz/x402): how pay-per-call x402 payments work and how to integrate them.
- [Ecosystem](https://www.miroshark.xyz/ecosystem): projects and partners building with MiroShark.
- [Blog](https://www.miroshark.xyz/blog): writing on MiroShark, agent simulation, and x402.
- [Changelog](https://www.miroshark.xyz/changelog): product updates.

## Run a simulation
- [Launch the run panel](https://www.miroshark.xyz/sim): describe a scenario and start a simulation (pay ~$1 via x402).

## Pricing
- About $1 per simulation, paid per-run via the x402 protocol on Base. No subscription.

## Optional
- [GitHub](https://github.com/MiroShark/MiroShark): source and stars.
- [X / Twitter](https://x.com/miroshark_): updates and contact.