Skip to content

michaelwrites67-ctrl/yogen

Repository files navigation

予言 Yogen — a 500-agent swarm that debates your idea and predicts the outcome

Tell Yogen what's on your mind — a startup idea, a price change, a decision you keep putting off. It spins up 12 named AI experts and a 488-agent crowd, they argue about it for six rounds, opinions cascade through a social graph, and you get a verdict with a full written report.

Not a chatbot giving you one opinion. A simulated debate where positions are earned.

A live Yogen simulation — 500 agents debating across believer, sceptic and resister clusters

Try it hosted (3 free sims): www.yogen.uk · Full demo video


Run it yourself — unlimited, free forever

git clone https://github.com/michaelwrites67-ctrl/yogen.git
cd yogen
npm install
cp .env.example .env      # add your Anthropic API key
npm start                 # → http://localhost:3005

That's it. Self-hosted Yogen has no simulation limits — you pay only your own Anthropic API usage (a full 500-agent sim costs roughly $0.20).

Requirements: Node 18+, an Anthropic API key.

How it works

your idea
   │
   ▼
┌─────────────────────────────────────────────────────┐
│ 1. Market intel + knowledge-graph extraction        │
│    (from your idea + any document you attach)       │
├─────────────────────────────────────────────────────┤
│ 2. 12 named experts generated for YOUR domain       │
│    4 positive · 4 sceptical · 4 negative            │
├─────────────────────────────────────────────────────┤
│ 3. 488 background agents in a social graph,         │
│    starting perfectly split 33/33/33                │
├─────────────────────────────────────────────────────┤
│ 4. Six rounds of debate. Experts argue; stances     │
│    change only when a point can't be answered.      │
│    Opinion cascades ripple through the crowd.       │
├─────────────────────────────────────────────────────┤
│ 5. Verdict + prediction report: strongest signals,  │
│    the one thing to check, concrete next steps —    │
│    each doable solo, in a browser, under 30 min.    │
└─────────────────────────────────────────────────────┘

You can argue back. Mid-debate, type into "Speak to the swarm" — correct an agent's assumption, add evidence — and the debate absorbs it in the next round.

The verdict

Every simulation ends with an Oracle Verdict, the final swarm split, and a full written report — strongest signals for and against, the single most important unknown, and next steps you can each do solo, in a browser, in under 30 minutes.

"Should OpenAI sack Sam Altman?" — Oracle Verdict: Mixed, with the 500-agent split 30% positive / 31% sceptical / 38% negative

The mechanics that keep it honest

  • Balanced start. The swarm begins exactly 33% positive / 33% sceptical / 33% negative. The verdict must be earned by the debate, never baked in.
  • Stance discipline. Agents hold their position unless a peer lands a point they cannot answer. Finding fault is not treated as insight.
  • Conviction score. Every verdict ships with a quality signal — how strongly the swarm converged and how many agents genuinely changed their mind — so you know whether to trust it.
  • No invented facts in reports. Agents improvise scenarios while debating (that's what debaters do); the final report is constrained to what you actually said, and tells you what to go and verify.

Stack

Plain Node.js + Express, one HTML file per page, zero front-end framework. Agents run on Claude Haiku (fast, cheap); report synthesis on Claude Sonnet. File-backed JSON storage — no database to set up.

server.js        routes, auth, SSE streaming, quotas
simulation.js    the debate engine — agent generation, rounds, report
rule-engine.js   488-agent crowd: social graph, cascades, coalitions
agents.js        expert persona generation
public/app.html  the simulator UI

Configuration

Everything is optional except the API key — see .env.example. Set UNLIMITED_SIMS=false and DAILY_SIM_LIMIT if you deploy it publicly and want quotas; Stripe and Google-OAuth vars exist for hosted billing/login and can be ignored.

License

AGPL-3.0. Use it, fork it, learn from it, self-host it freely. If you run a modified version as a service, you must open-source your modifications. The hosted service at yogen.uk is operated by Runn Ltd.

About

予言 Yogen — a 500-agent AI swarm that debates your idea and predicts the outcome. Self-host free with your own Anthropic key.

Topics

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors