PhoenixGo 开发者指南

PhoenixGo 开发者指南

PhoenixGo Go AI program which implements the AlphaGo Zero paper 项目地址: https://gitcode.com/gh_mirrors/ph/PhoenixGo

1. 项目目录结构及介绍

PhoenixGo 是一个开源的围棋AI项目，实现了AlphaGo Zero的论文。项目目录结构如下：

PhoenixGo/
├── common/               # 公共模块
├── dist/                 # 分布式训练相关模块
├── docs/                 # 文档
├── etc/                  # 配置文件
├── images/               # 图片资源
├── mcts/                 # 蒙特卡洛树搜索模块
├── model/                # 模型相关模块
├── scripts/              # 脚本文件
├── third_party/          # 第三方库
├── tools/                # 工具模块
├── .bazelrc              # Bazel配置文件
├── .gitignore            # Git忽略文件
├── .travis.yml           # Travis CI配置文件
├── BUILD                 # Bazel构建文件
├── LICENSE.TXT           # 许可证文件
├── PhoenixGo.sln         # Visual Studio解决方案文件
├── README.md             # 项目说明文件
├── ThirdParty.props      # 第三方库属性文件
├── WORKSPACE             # Bazel工作空间文件
└── configure             # 配置脚本

• common/: 包含项目共用的代码。
• dist/: 包含分布式计算相关的代码。
• docs/: 包含项目文档。
• etc/: 包含项目配置文件。
• images/: 包含项目所需图片。
• mcts/: 包含蒙特卡洛树搜索的实现。
• model/: 包含模型训练和加载的代码。
• scripts/: 包含项目运行的脚本。
• third_party/: 包含第三方库的代码。
• tools/: 包含项目工具代码。

2. 项目的启动文件介绍

启动文件位于项目的 scripts/ 目录下，主要包括以下文件：

• start.sh: 用于启动PhoenixGo的脚本。该脚本会自动检测GPU数量，并运行 mcts_main 程序。

  使用方式：

  scripts/start.sh
  

  若需要指定配置文件，可以使用以下命令：

  scripts/start.sh {config_path}
  

3. 项目的配置文件介绍

配置文件位于 etc/ 目录下，以下是主要的配置文件及其用途：

• mcts_1gpu.conf: 用于单GPU运行的配置文件示例。
• mcts_dist.conf: 用于分布式计算模式的配置文件示例。

配置文件中包含了一系列参数，例如：

• num_eval_threads: 应等于GPU数量。
• num_search_threads: 应略大于 num_eval_threads * eval_batch_size。
• timeout_ms_per_step: 每步棋的搜索时间。
• max_simulations_per_step: 每步棋的模拟次数。
• gpu_list: 指定使用的GPU列表。
• model_config: 模型配置，包括网络存储位置和检查点路径等。

配置文件的具体参数需要根据实际情况进行调整，以达到最佳的运行效果。

PhoenixGo Go AI program which implements the AlphaGo Zero paper 项目地址: https://gitcode.com/gh_mirrors/ph/PhoenixGo