Spaces:
Paused
Paused
| 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 | |