Simulations

A simulation is a complete run of your content through a crowd of AI agents. This guide covers everything from creating simulations to interpreting results.

Creating a Simulation

Every simulation starts with seed content, the material your crowd will react to. Go to /sim/new to begin.

Seed Types

CrowdProof supports three types of seed content:

Text

Raw text like a tweet, press release, product description, or announcement. This is the most flexible option. Agents react to exactly what you write.

We are excited to announce that starting next month, our premium plan will include unlimited API access at no additional cost.

URL

A link to any publicly accessible page. CrowdProof extracts the main content and presents it to agents. Useful for testing landing pages, articles, or competitor announcements.

https://example.com/blog/product-launch

Scenario

A hypothetical situation described in third person. This is ideal for testing "what if" questions or competitor moves.

Apple announces that the next iPhone will not include a charging port, requiring all charging to be done wirelessly.
Tip: More context produces better results. Include relevant details like pricing, timing, or target audience.

Audience Selection

Choose which crowd should react to your content. Each audience preset contains different archetypes with distinct personalities and perspectives.

PresetArchetypesBest For
General Public15+Consumer products, broad announcements
Tech Twitter12+Developer tools, startup launches, tech news
Small Business11+B2B products, pricing changes, services

See Audiences for detailed archetype lists.

Configuration Options

Agent Count

The number of AI agents participating in the simulation. More agents means more diverse reactions but longer processing time.

  • 100 agents: Quick test, limited faction formation
  • 250 agents: Good balance for most use cases
  • 500 agents: Rich faction dynamics, recommended for important decisions
  • 1000 agents: Enterprise tier, maximum diversity

Simulation Rounds

Each round allows agents to read and react to each other. More rounds show how opinions evolve and factions consolidate.

  • 3 rounds: Initial reactions only
  • 5 rounds: Early faction formation visible
  • 10 rounds: Full opinion evolution (default)
  • 20 rounds: Extended debate, useful for controversial topics

Running a Simulation

After clicking Run Simulation, you enter God Mode where agents begin reacting in real time. A typical simulation with 250 agents and 10 rounds takes 2-3 minutes.

You can pause, inject events, or let it run to completion. See God Mode for interface details.

Interpreting Results

When the simulation completes, you get a synthesis report. Here is how to read each section:

Overall Sentiment

A summary of whether reactions are predominantly positive, negative, or mixed. This gives you the quick answer: "How did people react?"

Faction Breakdown

A pie chart showing how agents clustered into opinion groups. Look for:

  • Dominant faction: What is the most common reaction?
  • Opposition size: How large is the negative response?
  • Curious/Pragmatic: Are people asking questions or waiting for more info?

Key Arguments

The most compelling points raised by agents on each side. These are summarized from actual agent posts. Use these to anticipate real objections and talking points.

Viral Moments

Content that spread rapidly through the crowd, receiving high engagement and reshares. This shows what messages resonate and which phrases stick.

Notable Quotes

Standout reactions from individual agents. These are selected for their representativeness, persuasiveness, or unexpected perspectives.

Sharing Reports

Click Share Report to generate a public link. Anyone with the link can view the synthesis without logging in. You can also:

  • Export as PDF for presentations
  • Export as CSV for data analysis
  • Embed the report in your internal tools

Running Follow-up Simulations

After reviewing results, you can run variations:

  • A/B testing: Run two versions of your announcement with the same audience
  • Different audiences: See how Tech Twitter vs General Public reacts
  • Refined messaging: Address objections raised in the first simulation

Next Steps

  • Audiences - Deep dive into audience presets and OCEAN model
  • API Reference - Automate simulations programmatically