File size: 3,307 Bytes
1794757 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 | ---
title: Trenches
emoji: 🌍
colorFrom: red
colorTo: gray
sdk: docker
app_port: 7860
---
<img width="512" height="512" alt="Image Background Remover (1)" src="https://github.com/user-attachments/assets/a1ab0df2-435f-444b-b8a1-36b1a64b55e8" />
# Trenches
A multi-agent crisis simulator built on [OpenEnv](https://github.com/openenv-ai/openenv). LLM agents navigate a fog-of-war geopolitical scenario — negotiating coalitions, managing deception, and responding to live global events — while a dedicated oversight agent monitors for dangerous escalation.
## Overview
Trenches drops six LLM-powered actors into a volatile 2026 Middle East crisis. Each agent operates under partial observability with role-specific intelligence, tools, and incentives. A scalable oversight mechanism intervenes when escalation risk crosses critical thresholds.
| Agent | Role | Model |
| ----------------- | ----------------------------------------------- | -------- |
| 🇺🇸 United States | Hawkish superpower balancing polls & projection | Qwen3-8B |
| 🇮🇱 Israel | Regional actor with strike autonomy | Qwen3-8B |
| 🇮🇷 Iran | Adversary leveraging proxies & deception | Qwen3-8B |
| 🪖 Hezbollah | Non-state militia with asymmetric tactics | Qwen3-8B |
| 🛢️ Gulf Coalition | Economic bloc protecting oil & stability | Qwen3-8B |
| 🔍 Oversight | Monitors all actors, intervenes on escalation | Qwen3-8B |
## Key Features
- **Fog of War** — agents see only their role-filtered intel, never the full world state
- **Live News Injection** — real-time RSS/OSINT feeds drive stochastic in-sim events
- **Scalable Oversight** — Bayesian risk scoring triggers interventions before runaway escalation
- **Tool Use** — agents call `query_intel`, `propose_negotiation`, `impose_sanctions`, etc.
- **Multi-component Rewards** — coalition stability, escalation penalty, market impact, belief alignment
## Stack
| Layer | Tech |
| -------- | ---------------------------------------------------- |
| Frontend | Next.js 16 · Tailwind v4 · Mapbox GL · Framer Motion |
| Backend | FastAPI · OpenEnv Core · NumPy |
| Infra | Docker · Bun · uv |
## Quick Start
```bash
# Frontend
bun install
bun run dev # → http://localhost:3000
# Backend
cd backend
uv sync
source .venv/bin/activate
uvicorn trenches_env.server:app --reload --port 8000
```
Set your environment variables in `.env.local`:
```
NEXT_PUBLIC_MAPBOX_TOKEN=...
NEXT_PUBLIC_API_URL=http://localhost:8000
```
## Project Structure
```
trenches/
├── app/ # Next.js app router + API routes
├── src/
│ ├── components/ # Globe, NewsFeed, ActivityLog, ChatPanel
│ ├── hooks/ # React hooks
│ └── lib/ # Types, utils, bootstrap
├── backend/
│ ├── src/ # FastAPI server, OpenEnv environment
│ └── tests/ # Backend test suite
├── entities/ # Agent identity configs (US, Israel, Iran, etc.)
└── scripts/ # Utility scripts
```
## License
MIT
|