julien-c HF staff Marissa commited on
Commit
208c706
1 Parent(s): 82bb810

Add model card (#1)

Browse files

- Add model card (d84a59a316cd33a871af3cdf245126fb0b00417e)


Co-authored-by: Marissa Gerchick <Marissa@users.noreply.huggingface.co>

Files changed (1) hide show
  1. README.md +204 -1
README.md CHANGED
@@ -1 +1,204 @@
1
- Test the whole generation capabilities here: https://transformer.huggingface.co/doc/gpt2-large
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language: en
3
+ license: mit
4
+ ---
5
+
6
+ # GPT-2 XL
7
+
8
+ ## Table of Contents
9
+ - [Model Details](#model-details)
10
+ - [How To Get Started With the Model](#how-to-get-started-with-the-model)
11
+ - [Uses](#uses)
12
+ - [Risks, Limitations and Biases](#risks-limitations-and-biases)
13
+ - [Training](#training)
14
+ - [Evaluation](#evaluation)
15
+ - [Environmental Impact](#environmental-impact)
16
+ - [Technical Specifications](#technical-specifications)
17
+ - [Citation Information](#citation-information)
18
+ - [Model Card Authors](#model-card-authors)
19
+
20
+ ## Model Details
21
+
22
+ **Model Description:** GPT-2 XL is the **1.5B parameter** version of GPT-2, a transformer-based language model created and released by OpenAI. The model is a pretrained model on English language using a causal language modeling (CLM) objective.
23
+
24
+ - **Developed by:** OpenAI, see [associated research paper](https://d4mucfpksywv.cloudfront.net/better-language-models/language_models_are_unsupervised_multitask_learners.pdf) and [GitHub repo](https://github.com/openai/gpt-2) for model developers.
25
+ - **Model Type:** Transformer-based language model
26
+ - **Language(s):** English
27
+ - **License:** [Modified MIT License](https://github.com/openai/gpt-2/blob/master/LICENSE)
28
+ - **Related Models:** [GPT-2](https://huggingface.co/gpt2), [GPT-Medium](https://huggingface.co/gpt2-medium) and [GPT-Large](https://huggingface.co/gpt2-large)
29
+ - **Resources for more information:**
30
+ - [Research Paper](https://d4mucfpksywv.cloudfront.net/better-language-models/language_models_are_unsupervised_multitask_learners.pdf)
31
+ - [OpenAI Blog Post](https://openai.com/blog/better-language-models/)
32
+ - [GitHub Repo](https://github.com/openai/gpt-2)
33
+ - [OpenAI Model Card for GPT-2](https://github.com/openai/gpt-2/blob/master/model_card.md)
34
+ - [OpenAI GPT-2 1.5B Release Blog Post](https://openai.com/blog/gpt-2-1-5b-release/)
35
+ - Test the full generation capabilities here: https://transformer.huggingface.co/doc/gpt2-large
36
+
37
+ ## How to Get Started with the Model
38
+
39
+ Use the code below to get started with the model. You can use this model directly with a pipeline for text generation. Since the generation relies on some randomness, we set a seed for reproducibility:
40
+
41
+ ```python
42
+ from transformers import pipeline, set_seed
43
+ generator = pipeline('text-generation', model='gpt2-xl')
44
+ set_seed(42)
45
+ generator("Hello, I'm a language model,", max_length=30, num_return_sequences=5)
46
+ ```
47
+
48
+ Here is how to use this model to get the features of a given text in PyTorch:
49
+
50
+ ```python
51
+ from transformers import GPT2Tokenizer, GPT2Model
52
+ tokenizer = GPT2Tokenizer.from_pretrained('gpt2-xl')
53
+ model = GPT2Model.from_pretrained('gpt2-xl')
54
+ text = "Replace me by any text you'd like."
55
+ encoded_input = tokenizer(text, return_tensors='pt')
56
+ output = model(**encoded_input)
57
+ ```
58
+
59
+ and in TensorFlow:
60
+
61
+ ```python
62
+ from transformers import GPT2Tokenizer, TFGPT2Model
63
+ tokenizer = GPT2Tokenizer.from_pretrained('gpt2-xl')
64
+ model = TFGPT2Model.from_pretrained('gpt2-xl')
65
+ text = "Replace me by any text you'd like."
66
+ encoded_input = tokenizer(text, return_tensors='tf')
67
+ output = model(encoded_input)
68
+ ```
69
+
70
+ ## Uses
71
+
72
+ #### Direct Use
73
+
74
+ In their [model card about GPT-2](https://github.com/openai/gpt-2/blob/master/model_card.md), OpenAI wrote:
75
+
76
+ > The primary intended users of these models are AI researchers and practitioners.
77
+ >
78
+ > We primarily imagine these language models will be used by researchers to better understand the behaviors, capabilities, biases, and constraints of large-scale generative language models.
79
+
80
+ #### Downstream Use
81
+
82
+ In their [model card about GPT-2](https://github.com/openai/gpt-2/blob/master/model_card.md), OpenAI wrote:
83
+
84
+ > Here are some secondary use cases we believe are likely:
85
+ >
86
+ > - Writing assistance: Grammar assistance, autocompletion (for normal prose or code)
87
+ > - Creative writing and art: exploring the generation of creative, fictional texts; aiding creation of poetry and other literary art.
88
+ > - Entertainment: Creation of games, chat bots, and amusing generations.
89
+
90
+ #### Misuse and Out-of-scope Use
91
+
92
+ In their [model card about GPT-2](https://github.com/openai/gpt-2/blob/master/model_card.md), OpenAI wrote:
93
+
94
+ > Because large-scale language models like GPT-2 do not distinguish fact from fiction, we don’t support use-cases that require the generated text to be true.
95
+ >
96
+ > Additionally, language models like GPT-2 reflect the biases inherent to the systems they were trained on, so we do not recommend that they be deployed into systems that interact with humans unless the deployers first carry out a study of biases relevant to the intended use-case. We found no statistically significant difference in gender, race, and religious bias probes between 774M and 1.5B, implying all versions of GPT-2 should be approached with similar levels of caution around use cases that are sensitive to biases around human attributes.
97
+
98
+ ## Risks, Limitations and Biases
99
+
100
+ **CONTENT WARNING: Readers should be aware this section contains content that is disturbing, offensive, and can propogate historical and current stereotypes.**
101
+
102
+ #### Biases
103
+
104
+ Significant research has explored bias and fairness issues with language models (see, e.g., [Sheng et al. (2021)](https://aclanthology.org/2021.acl-long.330.pdf) and [Bender et al. (2021)](https://dl.acm.org/doi/pdf/10.1145/3442188.3445922)).
105
+
106
+ The training data used for this model has not been released as a dataset one can browse. We know it contains a lot of unfiltered content from the internet, which is far from neutral. Predictions generated by the model can include disturbing and harmful stereotypes across protected classes; identity characteristics; and sensitive, social, and occupational groups. For example:
107
+
108
+ ```python
109
+ from transformers import pipeline, set_seed
110
+ generator = pipeline('text-generation', model='gpt2-xl')
111
+ set_seed(42)
112
+ generator("The man worked as a", max_length=10, num_return_sequences=5)
113
+
114
+ set_seed(42)
115
+ generator("The woman worked as a", max_length=10, num_return_sequences=5)
116
+ ```
117
+
118
+ This bias will also affect all fine-tuned versions of this model. Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model.
119
+
120
+ #### Risks and Limitations
121
+
122
+ When they released the 1.5B parameter model, OpenAI wrote in a [blog post](https://openai.com/blog/gpt-2-1-5b-release/):
123
+
124
+ > GPT-2 can be fine-tuned for misuse. Our partners at the Middlebury Institute of International Studies’ Center on Terrorism, Extremism, and Counterterrorism (CTEC) found that extremist groups can use GPT-2 for misuse, specifically by fine-tuning GPT-2 models on four ideological positions: white supremacy, Marxism, jihadist Islamism, and anarchism. CTEC demonstrated that it’s possible to create models that can generate synthetic propaganda for these ideologies. They also show that, despite having low detection accuracy on synthetic outputs, ML-based detection methods can give experts reasonable suspicion that an actor is generating synthetic text.
125
+
126
+ The blog post further discusses the risks, limitations, and biases of the model.
127
+
128
+ ## Training
129
+
130
+ #### Training Data
131
+
132
+ The OpenAI team wanted to train this model on a corpus as large as possible. To build it, they scraped all the web
133
+ pages from outbound links on Reddit which received at least 3 karma. Note that all Wikipedia pages were removed from
134
+ this dataset, so the model was not trained on any part of Wikipedia. The resulting dataset (called WebText) weights
135
+ 40GB of texts but has not been publicly released. You can find a list of the top 1,000 domains present in WebText
136
+ [here](https://github.com/openai/gpt-2/blob/master/domains.txt).
137
+
138
+ #### Training Procedure
139
+
140
+ The model is pretrained on a very large corpus of English data in a self-supervised fashion. This
141
+ means it was pretrained on the raw texts only, with no humans labelling them in any way (which is why it can use lots
142
+ of publicly available data) with an automatic process to generate inputs and labels from those texts. More precisely,
143
+ it was trained to guess the next word in sentences.
144
+
145
+ More precisely, inputs are sequences of continuous text of a certain length and the targets are the same sequence,
146
+ shifted one token (word or piece of word) to the right. The model uses internally a mask-mechanism to make sure the
147
+ predictions for the token `i` only uses the inputs from `1` to `i` but not the future tokens.
148
+
149
+ This way, the model learns an inner representation of the English language that can then be used to extract features
150
+ useful for downstream tasks.
151
+
152
+ The texts are tokenized using a byte-level version of Byte Pair Encoding (BPE) (for unicode characters) and a
153
+ vocabulary size of 50,257. The inputs are sequences of 1024 consecutive tokens.
154
+
155
+ ## Evaluation
156
+
157
+ The following evaluation information is extracted from the [associated paper](https://d4mucfpksywv.cloudfront.net/better-language-models/language_models_are_unsupervised_multitask_learners.pdf).
158
+
159
+ #### Testing Data, Factors and Metrics
160
+
161
+ The model authors write in the [associated paper](https://d4mucfpksywv.cloudfront.net/better-language-models/language_models_are_unsupervised_multitask_learners.pdf) that:
162
+
163
+ > Since our model operates on a byte level and does not require lossy pre-processing or tokenization, we can evaluate it on any language model benchmark. Results on language modeling datasets are commonly reported in a quantity which is a scaled or ex- ponentiated version of the average negative log probability per canonical prediction unit - usually a character, a byte, or a word. We evaluate the same quantity by computing the log-probability of a dataset according to a WebText LM and dividing by the number of canonical units. For many of these datasets, WebText LMs would be tested significantly out- of-distribution, having to predict aggressively standardized text, tokenization artifacts such as disconnected punctuation and contractions, shuffled sentences, and even the string <UNK> which is extremely rare in WebText - occurring only 26 times in 40 billion bytes. We report our main results...using invertible de-tokenizers which remove as many of these tokenization / pre-processing artifacts as possible. Since these de-tokenizers are invertible, we can still calculate the log probability of a dataset and they can be thought of as a simple form of domain adaptation.
164
+
165
+ #### Results
166
+
167
+ The model achieves the following results without any fine-tuning (zero-shot):
168
+
169
+ | Dataset | LAMBADA | LAMBADA | CBT-CN | CBT-NE | WikiText2 | PTB | enwiki8 | text8 | WikiText103 | 1BW |
170
+ |:--------:|:-------:|:-------:|:------:|:------:|:---------:|:------:|:-------:|:------:|:-----------:|:-----:|
171
+ | (metric) | (PPL) | (ACC) | (ACC) | (ACC) | (PPL) | (PPL) | (BPB) | (BPC) | (PPL) | (PPL) |
172
+ | | 8.63 | 63.24 | 93.30 | 89.05 | 18.34 | 35.76 | 0.93 | 0.98 | 17.48 | 42.16 |
173
+
174
+ ## Environmental Impact
175
+
176
+ 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). The hardware type and hours used are based on information provided by one of the model authors on [Reddit](https://bit.ly/2Tw1x4L).
177
+
178
+ - **Hardware Type:** 32 TPUv3 chips
179
+ - **Hours used:** 168
180
+ - **Cloud Provider:** Unknown
181
+ - **Compute Region:** Unknown
182
+ - **Carbon Emitted:** Unknown
183
+
184
+ ## Technical Specifications
185
+
186
+ See the [associated paper](https://d4mucfpksywv.cloudfront.net/better-language-models/language_models_are_unsupervised_multitask_learners.pdf) for details on the modeling architecture, objective, and training details.
187
+
188
+ ## Citation Information
189
+
190
+ ```bibtex
191
+ @article{radford2019language,
192
+ title={Language models are unsupervised multitask learners},
193
+ author={Radford, Alec and Wu, Jeffrey and Child, Rewon and Luan, David and Amodei, Dario and Sutskever, Ilya and others},
194
+ journal={OpenAI blog},
195
+ volume={1},
196
+ number={8},
197
+ pages={9},
198
+ year={2019}
199
+ }
200
+ ```
201
+
202
+ ## Model Card Authors
203
+
204
+ This model card was written by the Hugging Face team.