Tabletop RPG mechanics for multi-agent LLM simulation
It lets researchers simulate societies of LLM agents by having a Game Master referee their natural-language actions in grounded environments.

What it does
Concordia is a Python library that acts as a game engine for generative agents. Entities—agents and Game Masters—interact in simulated worlds by describing actions in natural language, and the Game Master interprets these and decides what actually happens, much like a tabletop RPG referee. The system targets researchers in social science, AI safety, economics, and synthetic data generation who need grounded multi-agent simulations.
The interesting bit
The architecture is deliberately modular: agents are assembled from reusable components for memory, reasoning, and sensory input, while the engine handles turn-taking and delegates outcome resolution to the GM. The README’s pub-dispute example shows agents reasoning through “what kind of situation is this?” and “what kind of person am I?”—a surprisingly simple behavioral model that keeps the simulation interpretable.
Key highlights
- Built around three primitives: Entities, Components, and an Engine loop.
- Ships with prefab agents and Game Masters, plus a
contribdirectory for user-built components. - Requires a standard LLM API and a text embedder for associative memory; it does not bundle its own model.
- Explicitly supports applications from cognitive neuroscience to performance evaluation of real services via simulated usage.
- Not an officially supported Google product.
Caveats
- You must bring your own LLM API and text embedder; Concordia is a framework, not a standalone model.
- Simulation fidelity depends entirely on the capabilities of the external LLM and embedder you choose.
- Local development may require dependency wrangling; the README nudges users toward GitHub Codespaces for a reproducible workflow.
Verdict
Researchers building interpretable multi-agent social simulations—and comfortable supplying their own LLM—will find a solid modular toolkit here. Everyone else should wait until they have a concrete scenario to model.
Frequently asked
- What is google-deepmind/concordia?
- It lets researchers simulate societies of LLM agents by having a Game Master referee their natural-language actions in grounded environments.
- Is concordia open source?
- Yes — google-deepmind/concordia is open source, released under the Apache-2.0 license.
- What language is concordia written in?
- google-deepmind/concordia is primarily written in Python.
- How popular is concordia?
- google-deepmind/concordia has 1.7k stars on GitHub and is currently accelerating.
- Where can I find concordia?
- google-deepmind/concordia is on GitHub at https://github.com/google-deepmind/concordia.