Experiments · reference scenarios

Pre-built
scenarios to
probe behaviour.

Explore the scenarios that ship with Nanda Town. Each one ran with the reference plugins — every metric here is reproducible from the seed in the YAML.

Filter
Warm rust circles trading positions with cream squares on beige paper — geometry of an open-air market.
Marketplace100 agents

Marketplace: 100 Agents

50 buyers and 50 sellers negotiate prices. Buyers make offers; sellers accept or reject. Tests how well agents find fair prices without a central authority.

Delivery

100%

Latency

2.1t

Msgs

2,200

Visualize →
A vertical stack of folded warm-orange paper rectangles on cream, only one slightly larger — sealed-bid auction.
Auction50 agents

Auction: 50 Bidders

An auctioneer posts items; 49 bidders compete. The highest bid wins each round. Tests whether agents settle on fair prices through competition.

Delivery

100%

Latency

1.8t

Msgs

1,850

Visualize →
Small rust-orange dots gathering toward a centroid on cream paper, like iron filings to a magnet.
Voting22 agents

Voting: Proposal & Election

A proposer submits topics, 20 voters cast yes/no ballots, and a coordinator counts the results. Tests simple group decision-making.

Delivery

100%

Latency

1.2t

Msgs

980

Visualize →
Concentric circles of warm orange ink radiating outward across cream paper.
Consensus7 agents

Quorum Consensus: 7 Nodes

A leader proposes values; followers vote to commit or abort. The value is committed when enough votes agree. Tests leader-based consensus with adjustable quorum sizes.

Delivery

100%

Latency

1t

Msgs

420

Visualize →
Horizontal pipeline of four warm rust nodes connected by hand-drawn cream-paper lines with watercolour bloom at each node.
Supply Chain4 agents

Supply Chain: 4-Hop Pipeline

Goods move from supplier to manufacturer to distributor to retailer. Each hop processes and passes them on. Tests whether the pipeline delivers reliably from end to end.

Delivery

100%

Latency

4t

Msgs

340

Visualize →
Field of warm-orange dots of varying opacity on cream paper, some clustered tightly, some isolated — reputation drift.
Reputation10 agents

Reputation: Trust & Betrayal

8 traders (6 honest, 2 cheaters) interact while an observer tracks their reputation scores. Tests whether the system correctly flags bad actors over time.

Delivery

100%

Latency

2.4t

Msgs

560

Visualize →
Stacked YAML-like horizontal lines flowing into a single warm rust beam of light on cream paper, with slight ink bleed.
Image — run your own

Bring your own scenario

Run Nanda Town
on your laptop.

Install the CLI and run any scenario with a single command. Define your own agents, protocols, and metrics in YAML — use the reference plugins or write your own.

$ pip install "nest-core[plugins]" $ nest run marketplace
Read the full guide →