← all repositories
Farama-Foundation/ChatArena

A Framework for LLM Social Games That Never Found Its Audience

It created structured worlds where LLMs could argue, deceive, and play chess using only natural language.

1.6k stars Python AgentsLanguage Models
ChatArena
Not currently ranked — collecting fresh signals.
star history

What it does

ChatArena is a Python framework that drops multiple LLM agents into structured language games—tic-tac-toe, rock-paper-scissors, social deduction, and free-form conversation—then manages their turns, observations, and rewards through a Markov Decision Process abstraction. It wraps environments, language backends, and player policies into a single loop, offering both Web UI and CLI frontends for running or debugging agent interactions.

The interesting bit

The framework treats natural-language observations as the only channel between agents and the hidden game state: players never see raw state vectors, only prose descriptions. This forces LLMs to reason and strategize purely through text, making the setup a useful probe for emergent social behavior.

Key highlights

  • Ships with ready-made environments including a social-deduction “Chameleon” game, chess via PettingZoo, and moderator-driven turn-taking games.
  • Supports swapping LLM backends—OpenAI GPT, Anthropic, Cohere, Hugging Face—without rewriting environment code.
  • Provides both a Gradio Web UI and an interactive CLI for prompt-engineering agents and watching them interact.
  • Exposes an Arena class that drives the main loop, plus hooks for custom environments, backends, and player policies.

Caveats

  • The project was deprecated in August 2025 because of a “lack of wide spread community use” and will receive no further updates or support.
  • The README cites an arXiv paper “coming soon” since at least 2023; it is unclear whether it was ever published.

Verdict

Worth a look if you are maintaining legacy multi-agent LLM experiments or want a reference architecture for language-only game environments. Skip it if you need an actively supported framework—this codebase is frozen.

Frequently asked

What is Farama-Foundation/ChatArena?
It created structured worlds where LLMs could argue, deceive, and play chess using only natural language.
Is ChatArena open source?
Yes — Farama-Foundation/ChatArena is open source, released under the Apache-2.0 license.
What language is ChatArena written in?
Farama-Foundation/ChatArena is primarily written in Python.
How popular is ChatArena?
Farama-Foundation/ChatArena has 1.6k stars on GitHub.
Where can I find ChatArena?
Farama-Foundation/ChatArena is on GitHub at https://github.com/Farama-Foundation/ChatArena.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.