ChatArena: 面向 LLM 的多智能体语言游戏环境

2025 年 8 月 11 日：由于缺乏广泛的社区使用，该项目已被弃用，目前不再计划提供任何额外的更新或支持。

---

ChatArena 是一个提供多智能体语言游戏环境的库，旨在促进对自主 LLM 智能体及其社会互动行为的研究。

它提供以下功能：

• 抽象化 (Abstraction)：基于马尔可夫决策过程 (MDP)，提供了一个灵活的框架来定义多个玩家、环境以及它们之间的交互。
• 语言游戏环境 (Language Game Environments)：提供了一系列环境，有助于理解、基准测试或训练 LLM 智能体。
• 用户友好的接口 (User-friendly Interfaces)：提供 Web UI 和 CLI，用于开发/提示工程 (prompt engineering)，使您的 LLM 智能体能够在环境中运行。

快速开始

尝试我们的在线演示：

安装

要求：

• Python >= 3.7
• OpenAI API key（可选，用于使用 GPT-3.5-turbo 或 GPT-4 作为 LLM 智能体）

使用 pip 安装：

pip install chatarena

或从源码安装：

pip install git+https://github.com/chatarena/chatarena

要使用 GPT-3 作为 LLM 智能体，请设置您的 OpenAI API key：

export OPENAI_API_KEY="your_api_key_here"

可选依赖

默认情况下，pip install chatarena 只会安装 ChatArena 核心功能所需的依赖项。 您可以使用以下命令安装可选依赖：

pip install chatarena[all_backends] # 安装所有受支持后端的依赖：anthropic, cohere, huggingface 等
pip install chatarena[all_envs]     # 安装所有环境的依赖，例如 pettingzoo
pip install chatarena[all]          # 安装所有可选依赖以获得完整功能

在本地启动演示

体验 ChatArena 最快的方法是通过演示 Web UI。 要在本地机器上启动演示，请先通过 pip 安装带有额外 gradio 依赖的 chatarena，然后 git clone 本仓库到本地文件夹，最后在仓库根目录调用 app.py：

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

这将启动一个 ChatArena 演示服务器，您可以通过浏览器（端口 8080）访问它。

观看此视频了解如何使用 Web UI：

开发指南

有关 ChatArena 框架的介绍，请参阅此文档。 关于构建新环境的详细指南，请查看

以下是我们提供的关于运行游戏所需最小配置的简洁指南及一些自定义建议。

核心概念

1. Arena：Arena 封装了一个环境和一组玩家。它驱动游戏的主循环，并提供诸如 WebUI、CLI、配置加载和数据存储等 HCI 工具。
2. Environment：环境存储游戏状态并执行游戏逻辑以进行状态转换。它还为玩家渲染观察结果，这些观察结果以自然语言形式呈现。