Ta20230804 commited on
Commit
14a3708
·
verified ·
1 Parent(s): 99f6914

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +27 -419
README.md CHANGED
@@ -13,50 +13,40 @@ base_model:
13
  pipeline_tag: text-generation
14
  ---
15
 
16
- # Model Card for Model ID
17
 
18
- <!-- Provide a quick summary of what the model is/does. -->
19
- このモデルは、国立情報学研究所の大規模言語モデル研究開発センターによって開発された大規模言語モデルllm-jp/llm-jp-3-13bをベースに、
20
- データセットichikara-instruction-003-001-1でファインチューニングしたモデルです。
21
 
22
  開発は東京大学松尾研究室の「大規模言語モデルDeepLearning応用講座」によって全面的にサポートされました。
23
 
24
 
25
- ## Model Details
26
 
27
- ### Model Description
28
-
29
- <!-- Provide a longer summary of what this model is. -->
30
-
31
- This is the model card of a 🤗 transformers model that has been pushed on the Hub.
32
-
33
- - **Developed by:** Ta20230804
34
- - **Language(s) (NLP):** Japanese
35
- - **License:** apache-2.0
36
- - **Finetuned from model [optional]:** llm-jp/llm-jp-3-13b
37
-
38
-
39
- ## Uses
40
-
41
-
42
- ## How to Get Started with the Model
43
-
44
- ### 実行環境
45
-
46
- - Omnicampus
47
  - L4 ( GPU:24GB)
48
 
49
- ### 推論実行方法
50
 
51
- - ライブラリのインストール
52
  ```
53
  !pip install -U bitsandbytes
54
  !pip install -U transformers
55
  !pip install -U accelerate
56
  !pip install -U datasets
57
  !pip install -U peft
 
58
  # notebookでインタラクティブな表示を可能とする(ただし、うまく動かない場合あり)
59
  !pip install ipywidgets --upgrade
 
 
 
 
 
 
 
 
60
  from transformers import (
61
  AutoModelForCausalLM,
62
  AutoTokenizer,
@@ -66,12 +56,6 @@ from peft import PeftModel
66
  import torch
67
  from tqdm import tqdm
68
  import json
69
- ```
70
-
71
- - 各種設定
72
- ```
73
- # Hugging Faceで取得したTokenをこちらに貼る。
74
- HF_TOKEN = "Hugging Face Token"
75
 
76
  # ベースとなるモデルと学習したLoRAのアダプタ。
77
  # model_idの値はomnicampusの環境におけるモデルのパスを表しており、それ以外の環境で実行する場合は変更の必要があります。
@@ -102,10 +86,8 @@ tokenizer = AutoTokenizer.from_pretrained(model_id, trust_remote_code=True, toke
102
  model = PeftModel.from_pretrained(model, adapter_id, token = HF_TOKEN)
103
  ```
104
 
105
- - データセット読み込み
106
  ```
107
- # データセットの読み込み。
108
- # omnicampusの開発環境では、左にタスクのjsonlをドラッグアンドドロップしてから実行。
109
  datasets = []
110
  with open("./elyza-tasks-100-TV_0.jsonl", "r") as f:
111
  item = ""
@@ -117,9 +99,8 @@ with open("./elyza-tasks-100-TV_0.jsonl", "r") as f:
117
  item = ""
118
  ```
119
 
120
- - 推論
121
  ```
122
- # llmjp
123
  results = []
124
  for data in tqdm(datasets):
125
 
@@ -146,385 +127,12 @@ for data in tqdm(datasets):
146
  results.append({"task_id": data["task_id"], "input": input, "output": output})
147
  ```
148
 
149
-
150
- ## Training Details
151
-
152
- ### Training Data
153
-
154
- <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
155
- - ichikara-instruction-003-001-1.json
156
-
157
- ### Training Procedure
158
-
159
- <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
160
- ```
161
- !pip install -U pip
162
- !pip install -U transformers
163
- !pip install -U bitsandbytes
164
- !pip install -U accelerate
165
- !pip install -U datasets
166
- !pip install -U peft
167
- !pip install -U trl
168
- !pip install -U wandb
169
- !pip install ipywidgets --upgrade
170
-
171
- from transformers import (
172
- AutoModelForCausalLM,
173
- AutoTokenizer,
174
- BitsAndBytesConfig,
175
- TrainingArguments,
176
- logging,
177
- )
178
- from peft import (
179
- LoraConfig,
180
- PeftModel,
181
- get_peft_model,
182
- )
183
- import os, torch, gc
184
- from datasets import load_dataset
185
- import bitsandbytes as bnb
186
- from trl import SFTTrainer
187
-
188
- HF_TOKEN = "Hugging Face Token"
189
-
190
- base_model_id = "models/models--llm-jp--llm-jp-3-13b/snapshots/cd3823f4c1fcbb0ad2e2af46036ab1b0ca13192a" #Fine-Tuningするベースモデル
191
- new_model_id = "llm-jp-3-13b-finetune" #Fine-Tuningしたモデルにつけたい名前
192
-
193
- """
194
- bnb_config: 量子化の設定
195
-
196
- - load_in_4bit:
197
- - 4bit量子化形式でモデルをロード
198
-
199
- - bnb_4bit_quant_type:
200
- - 量子化の形式を指定
201
-
202
- - bnb_4bit_compute_dtype:
203
- - 量子化された重みを用い��計算する際のデータ型
204
-
205
- """
206
-
207
- bnb_config = BitsAndBytesConfig(
208
- load_in_4bit=True,
209
- bnb_4bit_quant_type="nf4", # nf4は通常のINT4より精度が高く、ニューラルネットワークの分布に最適です
210
- bnb_4bit_compute_dtype=torch.bfloat16,
211
- )
212
-
213
- """
214
- model: モデル
215
-
216
- - base_model:
217
- - 読み込むベースモデル (事前に定義したもの)
218
-
219
- - quantization_config:
220
- - bnb_configで設定した量子化設定
221
-
222
- - device_map:
223
- - モデルを割り当てるデバイス (CPU/GPU) "auto"で自動に割り当てられます。
224
-
225
- tokenizer: トークナイザー
226
-
227
- - base_model:
228
- - 読み込むベースモデル (事前に定義したもの)
229
-
230
- - trust_remote_code:
231
- - リモートコードの実行を許可 (カスタムモデルなど)
232
- """
233
- model = AutoModelForCausalLM.from_pretrained(
234
- base_model_id,
235
- quantization_config=bnb_config,
236
- device_map="auto"
237
- )
238
-
239
- tokenizer = AutoTokenizer.from_pretrained(base_model_id, trust_remote_code=True)
240
-
241
- """
242
- find_all_linear_names: モデル内の4bit量子化線形層を探します。
243
- """
244
-
245
- def find_all_linear_names(model):
246
- cls = bnb.nn.Linear4bit # 4bit量子化線形層クラスを指定
247
- lora_module_names = set() # ここに取得した線形層を保持します。
248
-
249
- # モデル内の全てのモジュールを探索します
250
- for name, module in model.named_modules():
251
- if isinstance(module, cls): # モジュールが4bit量子化線形層の場合
252
- names = name.split('.') # モジュールの名前を分割 (ネストされてる際などに対処)
253
- lora_module_names.add(names[0] if len(names) == 1 else names[-1]) # 最下層の名前をlora_module_namesに追加
254
-
255
- # 'lm_head' は16ビット演算の際に除外する必要があるため、lora_module_namesから削除
256
- if 'lm_head' in lora_module_names:
257
- lora_module_names.remove('lm_head')
258
-
259
- return list(lora_module_names) # lora_module_namesをリストに変換して返します。
260
-
261
- modules = find_all_linear_names(model)
262
-
263
- """
264
- peft_config: PEFTの構成設定
265
-
266
- - r
267
- - LoRA のランク (4, 8, 16 ,32...)
268
- - 増やすほど学習が捗るが, 過学習のリスクも高まるので注意
269
-
270
- - lora_alpha
271
- - LoRAのスケーリング係数
272
-
273
- - lora_dropout
274
- - ドロップアウト率(過学習を防ぐための割合)
275
-
276
- - bias
277
- - バイアス項の扱い ("none"の場合、LoRAはバイアスを学習しない)
278
-
279
- - task_type
280
- - タスクタイプ
281
-
282
- - target_modules
283
- - LoRAを適用するターゲットモジュール (前のコードで特定した層)
284
- """
285
-
286
- peft_config = LoraConfig(
287
- r=16,
288
- lora_alpha=32,
289
- lora_dropout=0.05,
290
- bias="none",
291
- task_type="CAUSAL_LM",
292
- target_modules=modules,
293
- )
294
-
295
- model = get_peft_model(model, peft_config)
296
-
297
- """
298
- 学習に用いるデータセットの指定
299
- 今回はLLM-jp の公開している Ichikara Instruction を使います。データにアクセスするためには申請が必要ですので、使いたい方のみ申請をしてください。
300
- Ichikara Instruciton を Hugging Face Hub にて公開することはお控えください。
301
- また、CC-BY-NC-SAですのでモデルはライセンスを継承する前提でお使いください。
302
-
303
- 下記のリンクから申請を終えた先に Google Drive があり、Distribution20241221_all というフォルダごとダウンロードしてください。
304
- 今回は「ichikara-instruction-003-001-1.json」を使います。必要であれば展開(!unzip など)し、データセットのパスを適切に指定してください。
305
- omnicampusの開発環境では取得したデータを左側にドラッグアンドドロップしてお使いください。
306
-
307
- https://liat-aip.sakura.ne.jp/wp/llmのための日本語インストラクションデータ作成/llmのための日本語インストラクションデータ-公開/
308
- 関根聡, 安藤まや, 後藤美知子, 鈴木久美, 河原大輔, 井之上直也, 乾健太郎. ichikara-instruction: LLMのための日本語インストラクションデータの構築. 言語処理学会第30回年次大会(2024)
309
-
310
- """
311
-
312
- dataset = load_dataset("json", data_files="./ichikara-instruction-003-001-1.json")
313
- dataset
314
-
315
- prompt = """### 指示
316
- {}
317
- ### 回答
318
- {}"""
319
-
320
-
321
- """
322
- formatting_prompts_func: 各データをプロンプトに合わせた形式に合わせる
323
- """
324
- EOS_TOKEN = tokenizer.eos_token # トークナイザーのEOSトークン(文末トークン)
325
- def formatting_prompts_func(examples):
326
- input = examples["text"] # 入力データ
327
- output = examples["output"] # 出力データ
328
- text = prompt.format(input, output) + EOS_TOKEN # プロンプトの作成
329
- return { "formatted_text" : text, } # 新しいフィールド "formatted_text" を返す
330
- pass
331
-
332
- dataset = dataset.map(
333
- formatting_prompts_func,
334
- num_proc= 4, # 並列処理数を指定
335
- )
336
-
337
- dataset
338
-
339
- print(dataset["train"]["formatted_text"][3])
340
-
341
- """
342
- training_arguments: 学習の設定
343
-
344
- - output_dir:
345
- -トレーニング後のモデルを保存するディレクトリ
346
-
347
- - per_device_train_batch_size:
348
- - デバイスごとのトレーニングバッチサイズ
349
-
350
- - per_device_
351
- _batch_size:
352
- - デバイスごとの評価バッチサイズ
353
-
354
- - gradient_accumulation_steps:
355
- - 勾配を更新する前にステップを積み重ねる回数
356
-
357
- - optim:
358
- - オプティマイザの設定
359
-
360
- - num_train_epochs:
361
- - エポック数
362
-
363
- - eval_strategy:
364
- - 評価の戦略 ("no"/"steps"/"epoch")
365
-
366
- - eval_steps:
367
- - eval_strategyが"steps"のとき、評価を行うstep間隔
368
-
369
- - logging_strategy:
370
- - ログ記録の戦略
371
-
372
- - logging_steps:
373
- - ログを出力するステップ間隔
374
-
375
- - warmup_steps:
376
- - 学習率のウォームアップステップ数
377
-
378
- - save_steps:
379
- - モデルを保存するステップ間隔
380
-
381
- - save_total_limit:
382
- - 保存しておくcheckpointの数
383
-
384
- - max_steps:
385
- - トレーニングの最大ステップ数
386
-
387
- - learning_rate:
388
- - 学習率
389
-
390
- - fp16:
391
- - 16bit浮動小数点の使用設定(第8回演習を参考にすると良いです)
392
-
393
- - bf16:
394
- - BFloat16の使用設定
395
-
396
- - group_by_length:
397
- - 入力シーケンスの長さによりバッチをグループ化 (トレーニングの効率化)
398
-
399
- - report_to:
400
- - ログの送信先 ("wandb"/"tensorboard"など)
401
- """
402
-
403
- training_arguments = TrainingArguments(
404
- output_dir=new_model_id,
405
- per_device_train_batch_size=1,
406
- gradient_accumulation_steps=2,
407
- optim="paged_adamw_32bit",
408
- num_train_epochs=1,
409
- logging_strategy="steps",
410
- logging_steps=10,
411
- warmup_steps=10,
412
- save_steps=100,
413
- save_total_limit = 2,
414
- max_steps = -1,
415
- learning_rate=5e-5,
416
- fp16=False,
417
- bf16=False,
418
- seed = 3407,
419
- group_by_length=True,
420
- report_to="none"
421
- )
422
-
423
- """
424
- SFTTrainer: Supervised Fine-Tuningに関する設定
425
-
426
- - model:
427
- - 読み込んだベースのモデル
428
-
429
- - train_dataset:
430
- - トレーニングに使用するデータセット
431
-
432
- - eval_dataset:
433
- - 評価に使用するデータセット
434
-
435
- - peft_config:
436
- - PEFT(Parameter-Efficient Fine-Tuning)の設定(LoRAを利用する場合に指定)
437
-
438
- - max_seq_length:
439
- - モデルに入力されるシーケンスの最大トークン長
440
-
441
- - dataset_text_field:
442
- - データセット内の学習に使うテキストを含むフィールド名
443
-
444
- - tokenizer:
445
- - モデルに対応するトークナイザー
446
-
447
- - args:
448
- - トレーニングに使用するハイパーパラメータ(TrainingArgumentsの設定を指定)
449
-
450
- - packing:
451
- - 入力シーケンスのパッキングを行うかどうかの設定 (False に設定することで、各入力を独立して扱う)
452
- """
453
- trainer = SFTTrainer(
454
- model=model,
455
- train_dataset=dataset["train"],
456
- peft_config=peft_config,
457
- max_seq_length= 512,
458
- dataset_text_field="formatted_text",
459
- tokenizer=tokenizer,
460
- args=training_arguments,
461
- packing= False,
462
- )
463
-
464
- model.config.use_cache = False # キャッシュ機能を無効化
465
- trainer.train() # トレーニングを実行
466
-
467
- import json
468
- datasets = []
469
- with open("./elyza-tasks-100-TV_0.jsonl", "r") as f:
470
- item = ""
471
- for line in f:
472
- line = line.strip()
473
- item += line
474
- if item.endswith("}"):
475
- datasets.append(json.loads(item))
476
- item = ""
477
-
478
-
479
-
480
- from tqdm import tqdm
481
-
482
- results = []
483
- for data in tqdm(datasets):
484
-
485
- input = data["input"]
486
-
487
- prompt = f"""### 指示
488
- {input}
489
- ### 回答
490
- """
491
-
492
- tokenized_input = tokenizer.encode(prompt, add_special_tokens=False, return_tensors="pt").to(model.device)
493
- attention_mask = torch.ones_like(tokenized_input)
494
-
495
- with torch.no_grad():
496
- outputs = model.generate(
497
- tokenized_input,
498
- attention_mask=attention_mask,
499
- max_new_tokens=100,
500
- do_sample=False,
501
- repetition_penalty=1.2,
502
- pad_token_id=tokenizer.eos_token_id
503
- )[0]
504
- output = tokenizer.decode(outputs[tokenized_input.size(1):], skip_special_tokens=True)
505
-
506
- results.append({"task_id": data["task_id"], "input": input, "output": output})
507
  ```
508
-
509
- #### Training Hyperparameters
510
-
511
- - max-seq_length : 512
512
- - learning_rate : 5e-5
513
- - per_device_train_batch_size : 1
514
- - gradient_accumulation_ : 2
515
-
516
-
517
- ## Evaluation
518
-
519
- <!-- This section describes the evaluation protocols and provides the results. -->
520
- Omnicampusの自動採点にて2.66
521
-
522
- ### Testing Data, Factors & Metrics
523
-
524
- #### Testing Data
525
-
526
- <!-- This should link to a Dataset Card if possible. -->
527
- elyza-tasks-100-TV_0.jsonl
528
-
529
-
530
-
 
13
  pipeline_tag: text-generation
14
  ---
15
 
16
+ # モデル概要
17
 
18
+ このモデルは、国立情報学研究所の大規模言語モデル研究開発センターによって開発された大規模言語モデルllm-jp/llm-jp-3-13bをベースに、
19
+ データセットichikara-instruction-003-001-1でファインチューニングしたモデルです。
20
+ elyza-tasks-100-TV_0.jsonlを推論し、その結果を{adapter_id}-outputs.jsonlというファイルに出力できます。
21
 
22
  開発は東京大学松尾研究室の「大規模言語モデルDeepLearning応用講座」によって全面的にサポートされました。
23
 
24
 
25
+ ## 実行環境
26
 
27
+ - Python環境(Omnicampus、GoogleColabなど)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
28
  - L4 ( GPU:24GB)
29
 
30
+ ## 各種インストール
31
 
32
+ - ライブラリのインストール、HuggingFaceトークン格納
33
  ```
34
  !pip install -U bitsandbytes
35
  !pip install -U transformers
36
  !pip install -U accelerate
37
  !pip install -U datasets
38
  !pip install -U peft
39
+
40
  # notebookでインタラクティブな表示を可能とする(ただし、うまく動かない場合あり)
41
  !pip install ipywidgets --upgrade
42
+
43
+ # Hugging Faceで取得したTokenをこちらに貼る。
44
+ HF_TOKEN = "Hugging Face Token"
45
+
46
+ ```
47
+
48
+ ## モデル・トークナイザの読み込み
49
+ ```
50
  from transformers import (
51
  AutoModelForCausalLM,
52
  AutoTokenizer,
 
56
  import torch
57
  from tqdm import tqdm
58
  import json
 
 
 
 
 
 
59
 
60
  # ベースとなるモデルと学習したLoRAのアダプタ。
61
  # model_idの値はomnicampusの環境におけるモデルのパスを表しており、それ以外の環境で実行する場合は変更の必要があります。
 
86
  model = PeftModel.from_pretrained(model, adapter_id, token = HF_TOKEN)
87
  ```
88
 
89
+ ## データセット読み込み
90
  ```
 
 
91
  datasets = []
92
  with open("./elyza-tasks-100-TV_0.jsonl", "r") as f:
93
  item = ""
 
99
  item = ""
100
  ```
101
 
102
+ ## 推論実行
103
  ```
 
104
  results = []
105
  for data in tqdm(datasets):
106
 
 
127
  results.append({"task_id": data["task_id"], "input": input, "output": output})
128
  ```
129
 
130
+ ## 結果の出力
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
131
  ```
132
+ import re
133
+ jsonl_id = re.sub(".*/", "", adapter_id)
134
+ with open(f"./{jsonl_id}-outputs.jsonl", 'w', encoding='utf-8') as f:
135
+ for result in results:
136
+ json.dump(result, f, ensure_ascii=False) # ensure_ascii=False for handling non-ASCII characters
137
+ f.write('\n')
138
+ ```