开源项目使用教程：Thinking in Space

开源项目使用教程：Thinking in Space

thinking-in-space Official repo and evaluation implementation of VSI-Bench 项目地址: https://gitcode.com/gh_mirrors/th/thinking-in-space

1. 项目目录结构及介绍

Thinking in Space 项目目录结构如下：

thinking-in-space/
├── docs/                     # 项目文档
├── resources/                # 资源文件
├── lmms_eval/                # 评估工具
├── miscs/                    # 杂项脚本
├── other_scripts/            # 其他脚本
├── tools/                    # 工具脚本
├── transformers/             # Transformers 库
├── .gitignore                # Git 忽略文件
├── .gitmodules               # Git 子模块
├── LICENSE                   # 项目许可证
├── README.md                 # 项目说明文件
├── evaluate_all_in_one.sh    # 评估脚本
├── pyproject.toml            # 项目配置文件
└── setup.py                  # 设置文件

• docs/：包含项目的文档资料。
• resources/：存放项目所需的资源文件。
• lmms_eval/：评估工具，用于对模型进行评估。
• miscs/：包含一些杂项脚本，用于辅助项目开发。
• other_scripts/：存放其他辅助性脚本。
• tools/：包含项目所需的各种工具脚本。
• transformers/：Transformers 库，用于处理模型相关任务。
• .gitignore：指定 Git 忽略的文件和目录。
• .gitmodules：定义 Git 子模块。
• LICENSE：项目使用的许可证信息。
• README.md：项目说明文件，介绍项目的基本信息。
• evaluate_all_in_one.sh：一键评估脚本，用于执行评估流程。
• pyproject.toml：项目配置文件，定义项目依赖等配置。
• setup.py：设置文件，用于项目的安装和配置。

2. 项目的启动文件介绍

项目的主要启动文件是 evaluate_all_in_one.sh 脚本。该脚本用于启动评估流程，它将调用项目中的其他脚本和工具，对模型进行评估。运行该脚本前，确保已经安装了所有必要的依赖项。

运行方式：

bash evaluate_all_in_one.sh --model all --num_processes 8 --benchmark vsibench

该命令将启动一个评估流程，使用所有模型，开启 8 个进程，并指定评估基准为 vsibench。

3. 项目的配置文件介绍

项目的配置主要通过 pyproject.toml 文件进行。该文件定义了项目的依赖项和其他配置，如下所示：

[build-system]
requires = ["setuptools", "wheel"]

[tool.setuptools]
packages = ["."]
python_requires = ">=3.10"
install_reQUIRES = [
    "datasets",
    "transformers",
    "s2wrapper@git+https://github.com/bfshi/scaling_on_scales",
    "deepspeed"
]

在这个配置文件中，指定了项目所需的依赖项，包括 setuptools、wheel、datasets、transformers、s2wrapper 和 deepspeed。这些依赖项将在安装项目时自动安装。

以上就是 Thinking in Space 开源项目的目录结构、启动文件和配置文件的介绍。希望对您的使用有所帮助。

thinking-in-space Official repo and evaluation implementation of VSI-Bench 项目地址: https://gitcode.com/gh_mirrors/th/thinking-in-space