llm-colosseum

环境要求

• 按 https://docs.diambra.ai/#installation 完成 Diambra 环境安装
• 《街头霸王3》ROM 文件，放在 ~/.diambra/roms 目录（无需解压）
• Python 环境（可选：新建并激活独立的 venv）
• 准备一份 .env 文件，内容参照项目内的 .env.example
• 可选：已安装 Docker / docker-compose

安装与启动步骤

1. 1安装 Diambra 环境

   先按 Diambra 官方安装文档 https://docs.diambra.ai/#installation 完成前置环境安装，这是跑游戏模拟器的基础。

2. 2放置游戏 ROM

   下载《街头霸王3》ROM，放进 ~/.diambra/roms 目录，不需要解压压缩包内容。

3. 3创建虚拟环境

   可选步骤：用 Python 自带 venv 建独立环境，避免依赖冲突，创建后需激活再装依赖。

   python3 -m venv .venv
   source .venv/bin/activate

   复制

4. 4安装项目依赖

   在项目根目录安装 requirements.txt 中的依赖，直接用 make install 即可，也可用 pip 安装。

   make install

   复制

5. 5配置 .env 文件

   参照项目中的 .env.example 创建 .env，并按其内容填写（如模型接口等配置项）。

   cp .env.example .env

   复制

6. 6启动对战程序

   执行启动命令后，程序会加载 Diambra 环境并让 LLM 在游戏中对战。

   make run

   复制

7. 7Docker 构建与运行

   不想本地装依赖可用 Docker：先构建镜像，再运行容器并把本机 ROM 目录挂载进去。

   docker build -t diambra-app .
   docker run --name diambra-container -v ~/.diambra/roms:/app/roms diambra-app

   复制

8. 8Compose 跑 Ollama

   想用本地 Ollama 作为模型后端时，用 docker-compose 一键启动相关服务。

   docker-compose up

   复制

如何确认成功

执行 make run（或 docker run）后，能加载 Diambra 环境并出现《街头霸王3》对战画面，即表示启动成功。

常见问题

注意事项

• ROM 放入 ~/.diambra/roms 时无需解压，直接放压缩文件即可
• README 未列出 .env 的具体配置项，请以项目内 .env.example 为准
• 遇到容器名冲突可用 docker rm diambra-container 清理后再运行
• 使用 Docker 方式时记得用 -v 挂载本机 ROM 目录，否则容器内找不到 ROM