IMDLBenCo 文档IMDLBenCo 文档
  • 基本信息

    • 简介
    • 框架设计
  • 快速上手

    • 安装
    • 数据集准备
    • 案例一:使用Model Zoo训练复现SoTA论文
    • 案例二:使用Model Zoo配合checkpoint快速测试
    • 案例三:使用benco init实现你自己的模型
    • 案例四:推理并保存一个数据集的mask和label
    • 获得模型的参数量和FLOPs
  • API文档
  • 数据集

    • # 篡改检测数据集索引
    • AIGC生成内容数据集索引
  • 模型和论文

    • BenCo内实现的模型
    • 其他模型,算法,论文
  • English
  • 简体中文
GitHub
  • 基本信息

    • 简介
    • 框架设计
  • 快速上手

    • 安装
    • 数据集准备
    • 案例一:使用Model Zoo训练复现SoTA论文
    • 案例二:使用Model Zoo配合checkpoint快速测试
    • 案例三:使用benco init实现你自己的模型
    • 案例四:推理并保存一个数据集的mask和label
    • 获得模型的参数量和FLOPs
  • API文档
  • 数据集

    • # 篡改检测数据集索引
    • AIGC生成内容数据集索引
  • 模型和论文

    • BenCo内实现的模型
    • 其他模型,算法,论文
  • English
  • 简体中文
GitHub
  • 指南

    • 简介
    • 框架设计
  • 快速上手

    • 安装
    • 数据集准备
    • 案例一:使用Model Zoo训练复现SoTA论文
    • 案例二:使用Model Zoo配合checkpoint快速测试
    • 案例三:使用benco init实现你自己的模型
    • 案例四:推理并保存一个数据集的mask和label
    • 获得模型的参数量和FLOPs

安装

请注意,与大多数Paper提供的代码不同,Benco的仓库本身并不期望通过git clone等方式完成使用,因为实际代码中涉及到大量的工程开发所需的组件。期望的使用方法是直接通过pip install并将其当做Python库使用

对于普通用户

如果你只希望用IMDL-BenCo复现论文,并构建自己的模型,则IMDL-BenCo的安装方式非常简单,目前通过PyPI进行了包管理,直接通过如下指令即可完成

pip install imdlbenco

如果安装成功,在命令行中运行如下指令可以验证是否安装成功,并且自动检查是否有新版本。(本仓库处于迭代开发中,最好经常检查版本更新)

简写命令
benco -v 
完整命令
benco --version

如果正常安装了最新版本,应该可以看到如下内容:

IMDLBenCo codebase version: 0.1.21
        Checking for updates...
        Local version:  0.1.21
        PyPI newest version:  0.1.21
You are using the latest version: 0.1.21.

像其他的命令行工具一样,运行benco -h可以查看帮助引导等内容。

对于想为官方仓库贡献的开发者

如果你试图为IMDL-BenCo的Python Library在开发新功能并贡献到官方仓库,则需要按照本段完成。推荐你先在环境中卸载所有已经安装的IMDL-BenCo,然后克隆您fork过的IMDL-BenCo的仓库后,切换到dev分支获得最新的“开发版本”后,并使用特殊的pip install -e . 指令完成本地安装,这会使得当前Python环境始终根据本路径下的包所含的脚本执行IMDL-BenCo库,并在更新文件时自动更新相应执行行为,非常便于调试开发。

# 卸载已有的 IMDL-BenCo 库
pip uninstall imdlbenco

# 克隆 GitHub 上的 IMDL-BenCo 的fork过的仓库
git clone https://github.com/your_name/IMDL-BenCo.git

# 进入项目目录
cd IMDL-BenCo

# 使用 `pip install -e .` 进行本地开发安装
pip install -e .

# 验证安装
pip show imdlbenco

如果安装正常,执行pip list后应当看到

Package                 Version            Editable project location
----------------------- ------------------ ------------------------------------------------------
...
IMDLBenCo               0.1.10             /mnt/data0/xiaochen/workspace/IMDLBenCo_pure/IMDLBenCo
...

Editable Project Location 这一栏有对应的路径,即代表所有对于该路径下的python脚本修改可以直接生效于该Python环境内部,无需重新安装,非常便于调试。

在 GitHub 上编辑此页
上次更新: 2025/3/30 13:14
贡献者: Ma Xiaochen (马晓晨), Ma, Xiaochen
Next
数据集准备