ChatArena

搭建多智能体语言游戏场，锻炼 AI 沟通协作能力

ChatArena 是一个用于大语言模型（LLM）的多智能体语言游戏环境框架。它旨在通过构建丰富的语言交互场景，帮助开发者训练、评估和提升 AI 的沟通与协作能力。该项目提供了一套标准化的环境构建工具，支持自定义多智能体游戏规则，并集成了多种主流 LLM 后端，方便快速搭建模拟场景。其核心能力包括：环境状态管理、智能体通信协议、回合制游戏引擎以及可视化界面。通过模拟真实世界中的谈判、辩论、合作等任务，ChatArena 能够有效测试和增强模型在复杂社交情境下的表现，从而推动 AI 从单点任务处理向群体智能协作发展。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1563

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队Farama-Foundation

所属国家

官网地址

GitHubhttps://github.com/Farama-Foundation/ChatArena

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自由使用和部署，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型ai,artificial-intelligence,chatgpt,gpt-4,large-language-models,multi-agent,multi-agent-reinforcement-learning,multi-agent-simulation,natural-language-processing,python

GitHub 星标★ 1563

30天Star增速

HF 下载量

上线时间2023-03-06 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：库/依赖 6 步

环境要求

Python >= 3.7
可选：OpenAI API Key（用于把 GPT-3.5-turbo 或 GPT-4 作为 LLM 智能体）
可访问 PyPI 或 GitHub 的网络环境

安装与启动步骤

1检查 Python 版本

ChatArena 要求 Python 3.7 及以上，先确认本机 Python 版本满足要求再安装。
```
python --version
```
2安装 ChatArena

README 推荐直接用 pip 从 PyPI 安装，这是最快的方式。
```
pip install chatarena
```
3从源码安装(可选)

若需要最新代码或在线安装包不可用，可改用 Git 地址直接安装。
```
pip install git+https://github.com/chatarena/chatarena
```
4设置 OpenAI API Key

仅当要用 GPT-3.5-turbo 或 GPT-4 作为智能体时才需要；把占位值换成自己的真实 Key。
```
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"
```
5用 Python API 跑游戏

从配置文件加载 Arena 并运行若干回合。README 使用仓库里的 examples/nlp-classroom-3players.json；README 未给出 import 语句，需自行导入 Arena 类。
```
arena = Arena.from_config("examples/nlp-classroom-3players.json")
arena.run(num_steps=10)
```
6启动 CLI 交互界面

在 Python 中调用 launch_cli() 可进入交互式命令行界面，手动与智能体对局。
```
arena.launch_cli()
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	否	环境变量，用于调用 OpenAI 的 GPT-3.5-turbo / GPT-4 作为 LLM 智能体	`sk-xxxxxxxxxxxxxxxx`

如何确认成功

执行 arena.run(num_steps=10) 后无报错并正常输出对局内容，或 launch_cli() 能进入交互式命令行界面。

常见问题

Q：这个项目还在维护吗？

A：已停止维护。README 明确说明项目因社区使用不足，自 2025 年 8 月 11 日起弃用，不再计划接收任何更新或支持。

Q：没有 OpenAI API Key 能运行吗？

A：README 将 API Key 标为可选，只有使用 GPT-3.5-turbo 或 GPT-4 作为 LLM 智能体时才必须设置。

Q：examples/nlp-classroom-3players.json 找不到怎么办？

A：该文件位于项目源码仓库中。若用 pip 安装可能不含示例文件，需从 GitHub 仓库获取，或改用自己准备的配置文件。

Q：pip 安装失败怎么排查？

A：先确认 Python >= 3.7，然后改用 pip install git+https://github.com/chatarena/chatarena 从源码安装。

注意事项

项目已于 2025-08-11 弃用，不再获得更新与支持，仅适合学习或复现用途。
示例配置 examples/nlp-classroom-3players.json 在源码仓库中，pip 安装后未必随包提供。
API Key 属于敏感信息，不要把真实 Key 提交到代码仓库或公开分享。

核心亮点

提供标准化多智能体环境构建 API，降低自定义场景开发门槛
内置多种经典语言游戏（如谈判、猜词），可直接上手实验
支持与 OpenAI、HuggingFace 等主流 LLM 无缝集成，方便替换模型

不足之处

文档和示例相对较少，新手入门需要一定摸索
项目仍处于早期阶段，API 可能变动，稳定性待观察

适用场景

研究多智能体协作与竞争策略的学术实验
评估 LLM 在复杂对话场景中的表现与安全边界
构建模拟社交环境的 AI 训练与强化学习平台

替代项目

PettingZoo、MAgent、TextWorld

项目介绍

ChatArena 是智能体领域的开源项目，由 Farama-Foundation 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,563）位列前 30%，在智能体分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。Apache-2.0 许可证，可自由使用和部署，无付费版本。

它主要面向的使用场景是：研究多智能体协作与竞争策略的学术实验。同类可对比的替代方案包括 PettingZoo、MAgent、TextWorld。

上一篇：MineLand

下一篇：CORE