ChatArena

环境要求

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

安装与启动步骤

1. 1检查 Python 版本

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

   python --version

   复制

2. 2安装 ChatArena

   README 推荐直接用 pip 从 PyPI 安装，这是最快的方式。

   pip install chatarena

   复制

3. 3从源码安装(可选)

   若需要最新代码或在线安装包不可用，可改用 Git 地址直接安装。

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

   复制

4. 4设置 OpenAI API Key

   仅当要用 GPT-3.5-turbo 或 GPT-4 作为智能体时才需要；把占位值换成自己的真实 Key。

   export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"

   复制

5. 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. 6启动 CLI 交互界面

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

   arena.launch_cli()

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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