tenyyprn commited on
Commit
102e362
·
verified ·
1 Parent(s): 7fb5be3

Update README with detailed model card

Browse files
Files changed (1) hide show
  1. README.md +98 -191
README.md CHANGED
@@ -2,206 +2,113 @@
2
  base_model: Qwen/Qwen3-4B-Instruct-2507
3
  library_name: peft
4
  pipeline_tag: text-generation
 
 
 
5
  tags:
6
- - base_model:adapter:Qwen/Qwen3-4B-Instruct-2507
7
  - lora
8
  - transformers
 
 
 
 
9
  ---
10
 
11
- # Model Card for Model ID
12
 
13
- <!-- Provide a quick summary of what the model is/does. -->
14
 
 
15
 
16
-
17
- ## Model Details
18
-
19
- ### Model Description
20
-
21
- <!-- Provide a longer summary of what this model is. -->
22
-
23
-
24
-
25
- - **Developed by:** [More Information Needed]
26
- - **Funded by [optional]:** [More Information Needed]
27
- - **Shared by [optional]:** [More Information Needed]
28
- - **Model type:** [More Information Needed]
29
- - **Language(s) (NLP):** [More Information Needed]
30
- - **License:** [More Information Needed]
31
- - **Finetuned from model [optional]:** [More Information Needed]
32
-
33
- ### Model Sources [optional]
34
-
35
- <!-- Provide the basic links for the model. -->
36
-
37
- - **Repository:** [More Information Needed]
38
- - **Paper [optional]:** [More Information Needed]
39
- - **Demo [optional]:** [More Information Needed]
40
-
41
- ## Uses
42
-
43
- <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
44
-
45
- ### Direct Use
46
-
47
- <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
48
-
49
- [More Information Needed]
50
-
51
- ### Downstream Use [optional]
52
-
53
- <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
54
-
55
- [More Information Needed]
56
-
57
- ### Out-of-Scope Use
58
-
59
- <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
60
-
61
- [More Information Needed]
62
-
63
- ## Bias, Risks, and Limitations
64
-
65
- <!-- This section is meant to convey both technical and sociotechnical limitations. -->
66
-
67
- [More Information Needed]
68
-
69
- ### Recommendations
70
-
71
- <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
72
-
73
- Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
74
-
75
- ## How to Get Started with the Model
76
-
77
- Use the code below to get started with the model.
78
-
79
- [More Information Needed]
80
 
81
  ## Training Details
82
 
83
- ### Training Data
84
-
85
- <!-- 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. -->
86
-
87
- [More Information Needed]
88
-
89
- ### Training Procedure
90
-
91
- <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
92
-
93
- #### Preprocessing [optional]
94
-
95
- [More Information Needed]
96
-
97
-
98
- #### Training Hyperparameters
99
-
100
- - **Training regime:** [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
101
-
102
- #### Speeds, Sizes, Times [optional]
103
-
104
- <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
105
-
106
- [More Information Needed]
107
-
108
- ## Evaluation
109
-
110
- <!-- This section describes the evaluation protocols and provides the results. -->
111
-
112
- ### Testing Data, Factors & Metrics
113
-
114
- #### Testing Data
115
 
116
- <!-- This should link to a Dataset Card if possible. -->
117
-
118
- [More Information Needed]
119
-
120
- #### Factors
121
-
122
- <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
123
-
124
- [More Information Needed]
125
-
126
- #### Metrics
127
-
128
- <!-- These are the evaluation metrics being used, ideally with a description of why. -->
129
-
130
- [More Information Needed]
131
-
132
- ### Results
133
-
134
- [More Information Needed]
135
-
136
- #### Summary
137
-
138
-
139
-
140
- ## Model Examination [optional]
141
-
142
- <!-- Relevant interpretability work for the model goes here -->
143
-
144
- [More Information Needed]
145
-
146
- ## Environmental Impact
147
-
148
- <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
149
-
150
- Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
151
-
152
- - **Hardware Type:** [More Information Needed]
153
- - **Hours used:** [More Information Needed]
154
- - **Cloud Provider:** [More Information Needed]
155
- - **Compute Region:** [More Information Needed]
156
- - **Carbon Emitted:** [More Information Needed]
157
-
158
- ## Technical Specifications [optional]
159
-
160
- ### Model Architecture and Objective
161
-
162
- [More Information Needed]
163
-
164
- ### Compute Infrastructure
165
-
166
- [More Information Needed]
167
-
168
- #### Hardware
169
-
170
- [More Information Needed]
171
-
172
- #### Software
173
-
174
- [More Information Needed]
175
-
176
- ## Citation [optional]
177
-
178
- <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
179
-
180
- **BibTeX:**
181
-
182
- [More Information Needed]
183
-
184
- **APA:**
185
-
186
- [More Information Needed]
187
-
188
- ## Glossary [optional]
189
-
190
- <!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
191
-
192
- [More Information Needed]
193
-
194
- ## More Information [optional]
195
-
196
- [More Information Needed]
197
-
198
- ## Model Card Authors [optional]
199
-
200
- [More Information Needed]
201
-
202
- ## Model Card Contact
203
-
204
- [More Information Needed]
205
- ### Framework versions
206
-
207
- - PEFT 0.18.1
 
2
  base_model: Qwen/Qwen3-4B-Instruct-2507
3
  library_name: peft
4
  pipeline_tag: text-generation
5
+ language:
6
+ - en
7
+ - ja
8
  tags:
 
9
  - lora
10
  - transformers
11
+ - structured-output
12
+ - structeval
13
+ - csv-fix
14
+ license: apache-2.0
15
  ---
16
 
17
+ # Qwen3-4B StructEval Exp15 (CSV Fix)
18
 
19
+ Exp13 (SFT+DPO) をベースに、CSV変換の問題を修正するための特化LoRAアダプター。
20
 
21
+ ## Overview
22
 
23
+ | Item | Detail |
24
+ |------|--------|
25
+ | Base Model | Qwen/Qwen3-4B-Instruct-2507 |
26
+ | Parent Adapter | Exp13 (SFT + DPO, merged) |
27
+ | Purpose | CSV出力の「starting with header row」誤解釈を修正 |
28
+ | Method | Merged Exp13 + 追加LoRA fine-tuning |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
29
 
30
  ## Training Details
31
 
32
+ ### Strategy
33
+ - Exp13 DPOアダプターをベースモデルにマージ
34
+ - マージ後のモデルに対して、CSV修正用の小規模LoRAを追加学習
35
+
36
+ ### Hyperparameters
37
+
38
+ | Parameter | Value |
39
+ |-----------|-------|
40
+ | Learning Rate | 5e-5 |
41
+ | Epochs | 15 |
42
+ | Batch Size | 1 |
43
+ | Gradient Accumulation | 1 |
44
+ | LoRA r | 8 |
45
+ | LoRA alpha | 16 |
46
+ | LoRA dropout | 0.05 |
47
+ | Target Modules | q/k/v/o_proj, gate/up/down_proj |
48
+ | Precision | fp16 |
49
+ | Max Sequence Length | 2048 |
50
+ | Optimizer | AdamW |
51
+ | Seed | 3407 |
 
 
 
 
 
 
 
 
 
 
 
 
52
 
53
+ ### Training Data
54
+ - CSV修正用データセット(6サンプル)
55
+ - 「starting with header row」を正しく解釈し、ヘッダー+データ行を出力する学習
56
+
57
+ ### Hardware
58
+ - NVIDIA DGX Spark (GB10 Blackwell GPU)
59
+ - CUDA 12.1
60
+
61
+ ## Inference
62
+
63
+ ### System Prompt
64
+ ```
65
+ You are a structured data expert. Output the requested format directly without any explanation, preamble, or markdown code blocks. Do not write ```json, ```yaml, ```toml, ```xml, ```csv or similar. Output only the raw structured data.
66
+ ```
67
+
68
+ ### Settings
69
+ | Parameter | Value |
70
+ |-----------|-------|
71
+ | Temperature | 1e-7 (near-greedy) |
72
+ | Max New Tokens | 4096 |
73
+ | do_sample | False |
74
+
75
+ ### Usage
76
+ ```python
77
+ from transformers import AutoModelForCausalLM, AutoTokenizer
78
+ from peft import PeftModel
79
+ import torch
80
+
81
+ base_model_id = "Qwen/Qwen3-4B-Instruct-2507"
82
+ adapter_id = "tenyyprn/qwen3-4b-structeval-exp15"
83
+
84
+ tokenizer = AutoTokenizer.from_pretrained(base_model_id, trust_remote_code=True)
85
+ model = AutoModelForCausalLM.from_pretrained(
86
+ base_model_id,
87
+ torch_dtype=torch.float16,
88
+ device_map="auto",
89
+ trust_remote_code=True,
90
+ )
91
+ model = PeftModel.from_pretrained(model, adapter_id)
92
+ model = model.merge_and_unload()
93
+ model.eval()
94
+ ```
95
+
96
+ ## Results
97
+
98
+ Ensemble (Exp13 + Exp15) の公式コンペスコア: **0.781733**
99
+
100
+ ### Exp15 単体ローカル評価
101
+ | Format | Score |
102
+ |--------|-------|
103
+ | JSON | High |
104
+ | YAML | High |
105
+ | XML | High |
106
+ | CSV | Improved (fix applied) |
107
+ | TOML | Challenging |
108
+
109
+ ## Related Models
110
+ - Base: [Qwen/Qwen3-4B-Instruct-2507](https://huggingface.co/Qwen/Qwen3-4B-Instruct-2507)
111
+ - Parent (Exp13 DPO): SFT + DPO trained adapter (merged into this model)
112
+
113
+ ## License
114
+ Apache 2.0 (following base model license)