hormuz-agent-sandbox

<div align="center">

<img src="frontend/public/logo.png" alt="Peakstone Labs" width="200" />

# Strait of Hormuz Simulator

### Multi-Agent Geopolitical Sandbox

*Each nation is an independent AI agent. Tune the parameters. Watch the game theory emerge.*

<img src="videos/demo.gif" alt="Demo" width="700" />

[![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg)](#license)
[![Python 3.11+](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://python.org)
[![Vue 3](https://img.shields.io/badge/Vue-3-green.svg)](https://vuejs.org)

[**▶ Play Now**](https://game.peakstone-labs.com) · [Report Bug](https://github.com/Peakstone-Labs/hormuz-agent-sandbox/issues) · [Add a Country](#add-a-new-country)

**[English](#what-is-this)** | **[中文](#zh-cn)**

</div>

---

## What Is This?

A real-time geopolitical simulation powered by multiple AI agents, set against the **2026 Strait of Hormuz crisis** — a real, ongoing conflict as of April 2026.

Each country (Iran, US, Israel, Gulf States) is controlled by an independent LLM agent with its own:
- **Strategic doctrine** — goals, red lines, behavioral tendencies
- **Constraints** — missile stockpiles, economic tolerance, domestic politics
- **Information** — shared situation briefing + rolling memory of prior rounds

You configure the chaos level, activate scenario modifiers ("tags"), adjust each nation's parameters, and watch how the AI agents interact — producing emergent geopolitical dynamics that no single agent was programmed to create.

### Key Features

- 🎭 **4 AI-driven nations** with deeply researched behavioral profiles
- 🏷️ **11 pluggable scenario tags** (Houthi Wildcard, Nuclear Brinkmanship, China Mediator...)
- 🛢️ **Real-time oil market agent** that prices in geopolitical risk
- 🎛️ **20+ adjustable parameters** — aggressiveness, constraints, chaos factor
- 🌊 **SSE streaming** — watch each agent "think" in real-time
- 🌐 **Bilingual** — full Chinese/English support (UI + LLM output)
- 📊 **Shar