The short version
MiroFish is an AI simulation tool. You upload a document about your launch, it builds a crowd of virtual people with different backgrounds and opinions, and those people react to your launch and to each other over several rounds. You finish with a report that lists likely objections and misunderstandings, which you then test with real customers.
Overview
What MiroFish does
You give it a brief. It gives you a crowd that argues about it.
MiroFish describes itself as a swarm intelligence engine. It turns real-world source material such as news, policy drafts, analytical reports, or fiction into a parallel world of agents that have memory, motives, and social behavior. For a founder, the useful version is simple: your launch brief becomes the seed, and the agents become your early audience.
The workflow has five stages, and this guide walks through all of them:
| Stage | What happens |
|---|---|
| Ontology generation | Your document is turned into structured entities, motives, and factual anchors. |
| Graph construction | A relationship graph shows the actors, tensions, and memory structure behind your scenario. |
| Parallel simulation | Agents interact across Twitter-style and Reddit-style channels over multiple rounds. |
| Report generation | The trajectory is condensed into a prediction report with turning points, risks, and confidence signals. |
| Deep interaction | You question the ReportAgent or interview individual characters directly. |
The tool has been widely shared online, with reports of more than 75,000 GitHub stars and roughly $4 million in backing for the student who built it. Those figures come from social posts. Check the GitHub repository yourself before you quote them. The mirofish.my site lists the product as a v0.1 preview, so expect the interface to change.
Prerequisites
Before you start
- A launch you can describe in one to three pages, even if it is still a draft.
- A way to save that document as PDF, MD, or TXT. The upload limit is 50MB total.
- An account on MiroFish. You sign in from the homepage before the engine opens.
- A list of the questions you most want answered, such as pricing, trust, or clarity.
Write your launch brief
The simulation can only react to what you tell it. A vague brief produces a vague crowd, so put the effort in here.
- Open a blank document and copy the template below into it.
- Fill in every field with plain, factual sentences. Write what you would say on the sales page.
- Add your real weak spots. The crowd finds them anyway, and naming them gives the simulation something to test.
- List the two or three competitors or alternatives your buyers already use.
- Save the file as launch-brief.md or launch-brief.pdf.
LAUNCH BRIEF
Product: [name]
What it is: [one plain sentence]
Who it is for: [role, business size, situation]
Price and offer: [price, bonuses, guarantee, deadline]
Launch date and channels: [date, where you will announce it]
Key claims we will make:
- [claim 1]
- [claim 2]
- [claim 3]
Known weak spots:
- [what a skeptic would point at first]
Competitors and alternatives:
- [name and what it does better or worse]
Questions we expect from buyers:
- [question 1]
- [question 2]
Keep the brief close to the final copy you plan to publish. The closer it is to what buyers will see, the more useful the reactions are.
Sign in to MiroFish
- Open the MiroFish homepage in your browser.
- Click Sign In in the top right corner.
- Finish the sign-in flow. The console button on the homepage reads Sign in to start engine until you do.
Plans and limits are listed at mirofish.my/pricing. Check it before you plan a large run.
Upload your brief
- Find the panel labelled Reality Seeds in the engine console.
- Choose Upload File, or drag your file into the drop area.
- Confirm the file type is PDF, MD, Markdown, or TXT and that the total size is under 50MB.
- If your launch details live on a web page, use Import Link instead.
Remove anything confidential before you upload, such as unreleased pricing you have not approved for sharing, customer names, or private financials. Read the MiroFish privacy policy so you know how uploads are handled.
Add your simulation prompt
The prompt tells the crowd what to focus on. One clear question beats a list of five.
- Find the panel labelled Simulation Prompt.
- Paste one of the prompts below. Start with the first one on your first run.
- Replace the bracketed parts with your own details.
Launch stress test. This is the prompt MiroFish suggests for product launches, open betas, and brand announcements.
Simulate how customers, competitors, and commentators react to this
launch brief, and identify the most expensive misunderstanding if left
unanswered.
Price test. Use this when you are unsure about your number.
Simulate how potential buyers and skeptics react to the price of
[price] in this launch brief over three rounds. Show which objections
appear first, which ones spread, and what proof would change their minds.
Competitor comparison. Use this when buyers already have an alternative.
Simulate how buyers compare this launch with [competitor]. Identify
which claims they believe, which they doubt, and which comparison
gets the largest group to switch.
Run the same brief with a different prompt each time. Each run gives you a fresh angle without rewriting the document.
Check the graph before you run
MiroFish first extracts the people and pressures in your brief. This is your chance to catch a misread.
- Start the engine. MiroFish moves through ontology generation and graph construction.
- Open the graph view and look at the actors it found: buyers, competitors, commentators, and any groups you named.
- Check that your main audience is present and that the tensions match your real concerns, such as price against value.
- If a key actor or concern is missing, edit your brief to state it directly, then upload the new version.
A simulation built on a wrong graph produces confident nonsense. Ten minutes fixing the brief here saves you from acting on a bad report.
Run the simulation
- Start the parallel simulation from the console.
- Watch the feed. Agents post, reply, argue, and shift their opinions across Twitter-style and Reddit-style surfaces.
- Note the first objection that appears and who raises it.
- Note any reaction that spreads quickly, even when it is wrong. A wrong idea that travels is a messaging problem you can fix before launch.
- Wait for all rounds to finish before you move on.
The MiroFish site says a run can involve a very large number of parallel agents. Larger runs take longer, so start with a smaller simulation while you learn the tool.
Read the prediction report
The report is the deliverable. Read it with a pen and mark every claim you can check.
- Open the report view once the simulation completes.
- Read the executive summary first and write down the dominant risk in one sentence.
- Scan the predicted developments, major risks, key actors, and evidence lines.
- Copy every objection and misunderstanding into a single list, ordered by how early it appeared and how far it spread.
- Mark the confidence signals. Where confidence is low, treat the finding as a question, not an answer.
MiroFish frames its forecasts as inspectable hypotheses, not certainty. Its own site says results should be reviewed before operational or financial decisions. Treat the report as a source of things to test.
Turn objections into tests
This is where the simulation pays off. Each objection becomes a small experiment with real customers.
- Use the deep interaction step to question the ReportAgent. Ask why a specific objection spread.
- Interview individual characters. Ask a skeptical buyer what single change would earn their trust.
- Take your objection list and match each item to a test in the table below.
- Run the tests with five to ten real people from your audience before you launch.
- Update your brief with what you learn, then run a second simulation to see if the reaction shifts.
| Objection type | What to look for in the report | Real-world test |
|---|---|---|
| Price | Agents say it costs too much or compare it with a cheaper option. | Show the offer to five buyers and ask what they would expect to get at that price. |
| Trust | Agents ask for proof, results, or a guarantee. | Send two versions of your proof section and ask which one they believe. |
| Clarity | Agents misdescribe what the product does. | Ask a buyer to explain your offer back to you in their own words. |
| Competitor | Agents keep naming an alternative. | Ask current users of that alternative what would make them switch. |
| Timing | Agents say they will wait or come back later. | Test a deadline or bonus on a small group and compare response. |
Checklist
Launch test checklist
Tick items off as you go. Your progress stays for this browser session.
0 of 8 complete
FAQ
Questions
What is MiroFish?
MiroFish is an AI simulation workspace that turns source material into a graph of actors, a multi-agent simulation, and a forecast report. It is described as a swarm intelligence engine.
Can MiroFish predict how customers will react to my launch?
It shows plausible reactions, objections, and misunderstandings. The forecasts are exploratory, so confirm every finding with real customers before you change your offer.
What file types can I upload?
PDF, Markdown, and plain text, up to 50MB total. You can also import a link.
What does the report include?
An executive summary, predicted developments, major risks, evidence lines, key actors, and a long-form narrative of how the outcome unfolds.
Can I use it for things other than launches?
Yes. The built-in scenarios cover public opinion events, policy reactions, brand crises, finance cases, and fiction. The launch reaction scenario is the one this guide follows.
Is it free?
Check mirofish.my/pricing for current plans. The product is a preview, so details can change.
Next step
Build your first agent
Take the next step with AI Savvy Founders and put an agent to work in your business.
Build your first agent