ChatArena

What does this agent do, and when should you use it?

ChatArena is a Python library for studying autonomous LLM agents and their social interactions through multi-agent language games. Its core model consists of Arena, Environment, Language Backend, and Player: Arena manages the game loop, configuration loading, data storage, and HCI utilities such as a Web UI and CLI. Environments hold game state, apply transition logic, and render natural-language observations that players use to act. The repository includes conversation, moderator-led conversation, Chameleon, and PettingZoo-backed chess and tic-tac-toe environments, with JSON examples for running games. The project was declared deprecated on August 11, 2025, with no additional updates or support planned, so it is better suited to reproduction, experimentation, or self-maintained extensions than to a dependency requiring active upstream support.

A user can create an Arena from a JSON file with Arena.from_config("examples/nlp-classroom-3players.json") and advance the game with arena.run(num_steps=10). Arena coordinates Players and an Environment in the main loop; the Environment manages state, transitions, observations, terminal conditions, and rewards through mechanisms including step, reset, get_observation, is_terminal, and get_rewards. A Player receives a natural-language observation and, by default, queries a Language Backend before returning its response as an action. The project also exposes arena.launch_cli() for interactive use and a local Gradio Web UI launched with gradio app.py. New environments are created by extending Environment, assigning type_name, and adding the class to ALL_ENVIRONMENTS.

1. A multi-agent researcher needs a turn-based framework for testing communication, collaboration, or social interaction among LLM players.
2. A prompt engineer wants to run a configured multi-player interaction, such as examples/nlp-classroom-3players.json, without writing a game loop.
3. A teaching or prototyping team wants to use the Chameleon social-deduction game to inspect reasoning and voting under asymmetric information.
4. An experimenter wants to contrast LLM-moderated rock-paper-scissors or tic-tac-toe with PettingZoo environments driven by hard-coded rules.
5. A Python developer wants to implement a new language game with custom state, observations, rewards, and step logic.

What are this agent's strengths and limitations?

How do you install or deploy this agent?

The README body lists Python >= 3.7 as the requirement, while its badge says Python 3.9+. Install the core package:

pip install chatarena

Install all supported backend dependencies:

pip install chatarena[all_backends]

Install all environment dependencies:

pip install chatarena[all_envs]

Install all optional dependencies:

pip install chatarena[all]

For GPT-3.5-turbo or GPT-4 agents, set the optional credential:

export OPENAI_API_KEY="your_api_key_here"

How do you use this agent?

Create and run a game from the repository example configuration:

arena = Arena.from_config("examples/nlp-classroom-3players.json")
arena.run(num_steps=10)

Launch the interactive CLI:

arena.launch_cli()

Launch the local Web UI:

pip install chatarena[gradio]
git clone https://github.com/chatarena/chatarena.git
cd chatarena
gradio app.py

The README says the demo server can then be accessed in a browser on port 8080.

FAQ