Skip to content

Commit db97782

Browse files
sallyjunjunzigzagcaiSlinkierApple13
authored
feat(huggingface): native support for huggingface model and dataset (#244)
Co-authored-by: zigzagcai <caizheng@pjlab.org.cn> Co-authored-by: SlinkierApple13 <18917988589@163.com>
1 parent 98ff6f8 commit db97782

33 files changed

+970
-420
lines changed

doc/code-docs/source/checkpoint.rst

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ CheckpointManager
1616

1717
- ``checkpoint_every``: 检查点存储频率,参数类型 ``int``,默认为: ``50``。
1818

19-
- ``load_ckpt_folder``: 初始化检查点/权重加载路径。参数类型 ``str``,默认为: ``None``,详见 :ref:`load-ckpt-folder`。
19+
- ``load_ckpt_info``: 初始化检查点/权重加载信息。参数类型 ``dict``,默认为: ``None``,详见 :ref:`load-ckpt-info`。
2020

2121
- ``async_upload``: 是否开启异步上传,默认值为:``False``,详见 :ref:`asyncupload`。
2222

@@ -36,8 +36,8 @@ CheckpointManager
3636
ckpt = dict(
3737
enable_save_ckpt=False, # enable ckpt save.
3838
save_ckpt_folder=SAVE_CKPT_FOLDER, # Path to save training ckpt.
39-
load_ckpt_folder=dict(path="local:/mnt/mfs/ckpt", content=["all",], ckpt_type="internlm"),
40-
auto_resume=False, # disable auto-resume, internlm will load model checkpoint from the path of 'load_ckpt_folder'.
39+
load_ckpt_info=dict(path="local:/mnt/mfs/ckpt", content=["all",], ckpt_type="internlm"),
40+
auto_resume=False, # disable auto-resume, internlm will load model checkpoint from the path of 'load_ckpt_info'.
4141
checkpoint_every=CHECKPOINT_EVERY,
4242
async_upload=True, # async ckpt upload. (only work for boto3, volc and oss2 ckpt)
4343
async_upload_tmp_folder="/dev/shm/internlm_tmp_ckpt/", # path for temporarily files during asynchronous upload.
@@ -52,7 +52,7 @@ CheckpointManager
5252
加载与存储格式约定
5353
--------------------------
5454

55-
.. _load-ckpt-folder:
55+
.. _load-ckpt-info:
5656

5757
(1) 路径格式约定
5858
~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -75,10 +75,10 @@ InternEvo对config中出现的所有存储路径都遵循以下的路径格式
7575

7676

7777

78-
(2) 模型加载(load_ckpt_folder)格式约定
78+
(2) 模型加载(load_ckpt_info)格式约定
7979
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8080

81-
load_ckpt_folder 由三个字段组成, ``path`` 、 ``content`` 和 ``ckpt_type`` 。
81+
load_ckpt_info 由三个字段组成, ``path`` 、 ``content`` 和 ``ckpt_type`` 。
8282

8383
- ``path``:给出了检查点/初始化模型权重的加载路径(path的格式见下小节)
8484

@@ -92,17 +92,23 @@ load_ckpt_folder 由三个字段组成, ``path`` 、 ``content`` 和 ``ckpt_ty
9292

9393
- ``ckpt_type``:表示加载的模型权重类型,目前支持的字段包括:
9494

95-
- ``internlm``:internevo约定的checkpoint存储格式。
95+
- ``internevo``:internevo约定的checkpoint存储格式。
96+
- ``llama``:llama约定的checkpoint存储格式。
97+
- ``hf_llama``:huggingface llama约定的checkpoint存储格式。
98+
- ``hf_model``:适用于加载huggingface所有模型的checkpoint存储格式。
9699

97100
下面给出两个例子:
98101

99102
.. code-block:: python
100103
101104
# 从文件存储相对路径 ckpt_model 中加载已有模型权重初始化模型,适合 sft 等训练初始化
102-
load_ckpt_folder= dict(path="local:ckpt_model", content=["model",], ckpt_type="internlm")
105+
load_ckpt_info = dict(path="local:ckpt_model", content=("model",), ckpt_type="internevo")
103106
104107
# 从文件存储相对路径 ckpt_model 中加载所有的状态,适合断点续训的场景
105-
load_ckpt_folder= dict(path="local:ckpt_model", content=["all",], ckpt_type="internlm")
108+
load_ckpt_info = dict(path="local:ckpt_model", content=("all",), ckpt_type="internevo")
109+
110+
# 从 huggingface 下载指定模型,加载checkpoint
111+
load_ckpt_info = dict(path="internlm/internlm-7b", content=("model",), ckpt_type="hf_model")
106112
107113
108114
.. _asyncupload:
@@ -144,13 +150,13 @@ config.ckpt 中相关的参数:
144150

145151
检查点自动加载功能的目的是在resume训练时,自动加载 ``save_ckpt_folder`` 路径下最新的检查点(包括snapshot检查点)。配合上自动重启机制,可以实现无人干预的任务自动恢复。
146152

147-
该功能默认开启,所以要注意如果需要加载 ``load_ckpt_folder`` 路径下的模型权重,要将 ``auto_resume`` 设置为 False,否则可能会产生预期外的行为。
153+
该功能默认开启,所以要注意如果需要加载 ``load_ckpt_info`` 路径下的模型权重,要将 ``auto_resume`` 设置为 False,否则可能会产生预期外的行为。
148154

149155
config.ckpt 中相关的参数:
150156

151157
- ``auto_resume``: 是否开启检查点自动恢复。参数类型 ``bool``,默认为 ``True``。
152158

153-
``auto_resume`` 如果为True,则尝试从 ``save_ckpt_folder`` 路径中自动加载最新的ckpt,如果找不到,则从step 0开始训练。如果为False,则尝试从 ``load_ckpt_folder`` 中加载模型参数。
159+
``auto_resume`` 如果为True,则尝试从 ``save_ckpt_folder`` 路径中自动加载最新的ckpt,如果找不到,则从step 0开始训练。如果为False,则尝试从 ``load_ckpt_info`` 中加载模型参数。
154160

155161

156162
.. _stopfile:

doc/code-docs/source/initialize.rst

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -77,17 +77,19 @@ InternEvo 在配置文件中使用字段 ``model_type`` 和 ``model`` 来控制
7777
- 字段 ``model_type`` 指明了要初始化的模型类型
7878
- 字段 ``model`` 中的参数指定了在模型初始化过程中的参数设置
7979

80-
值得注意的是,用户可以定义新的模型类型,并使用装饰器 ``@MODEL_INITIALIZER.register_module`` 注册模型的初始化函数,其中 ``MODEL_INITIALIZER`` 是类 ``internlm.util.registry.Registry`` 的一个实例化对象,示例如下所示:
80+
值得注意的是,用户可以定义新的模型类型,并通过 ``register_module`` 注册模型的初始化函数,示例如下所示:
8181

8282
.. code-block:: python
8383
84-
MODEL_TYPE = "NEW_MODEL"
84+
model_initializer = Registry("model_initializer")
8585
86-
@MODEL_INITIALIZER.register_module(module_name=MODEL_TYPE)
87-
def build_new_model_with_cfg(*args, **kwargs):
86+
def register_model_initializer() -> None:
87+
model_initializer.register_module("INTERNLM", InternLM1)
8888
8989
.. _InternLM-optim-init:
9090

91+
其中,"INTERNLM"为新的模型类型,InternLM1为新模型的入口函数。
92+
9193
优化器初始化
9294
-------------------------
9395

0 commit comments

Comments
 (0)