Concordia Simulation Builder - System Architecture
Frontend (React + TypeScript + Tailwind)
Simulation Builder
Template Picker + Config
Agents, GM (Game Master), Scenarios, LLM
Simulation Runner
9 Tabs: Log, Stats, Timeline,
Actions, Summary, Variables,
Cooperation, Analysis, Component Logs
Recent Simulations
Log Browser + Import/Export
Collapsible Sidebar
HTTP / SSE (Server-Sent Events) (Real-time)
Backend (FastAPI + Python)
Sim Builder
38 Templates + Prefabs
Config Validation
Sim Runner
Threaded Execution
Checkpoints + SSE
Sim State
Per-Run Isolation
Cancellation Control
LLM Factory
Multi-Provider Clients
Agent + GM LLM
Sim Analyzer
HTML Log Parsing
LLM-Powered Analysis
Census Generator
Demographic Sampling
Marginal + Joint Distributions
Batch Runner
Parameter Sweeps
Parallel Execution
Concordia Framework Integration Layer
API Calls
LLM Providers (8 supported, separate Agent + GM selection)
OpenAI
Chat + Reasoning
Azure
Azure OpenAI
DeepSeek
Chat + Reasoning
Anthropic
Chat + Reasoning
Gemini
Google
Ollama
Local + Remote
GLM
Zhipu AI
Data Flow:
1. User picks template or builds from scratch via Builder
2. Selects LLM provider/model (separate for agents and GM)
3. Backend validates config, maps prefabs, builds simulation
4. Runner executes with SSE progress + checkpoints
Data Flow (continued):
5. LLM calls drive agent behaviors + grounded variable updates
6. Results saved as HTML log + .metadata.json sidecar
7. Analyzer extracts structured data from HTML logs
8. 9-tab dashboard: stats, timeline, summary, analysis, etc.
* Auto-discovered models: OpenAI, Anthropic, and Ollama dynamically fetch available models from their respective APIs.
Updated: 2026-05-10 | Concordia v2.4