RichardErkhov commited on
Commit
1fc5728
1 Parent(s): 938a656

uploaded readme

Browse files
Files changed (1) hide show
  1. README.md +600 -0
README.md ADDED
@@ -0,0 +1,600 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ Quantization made by Richard Erkhov.
2
+
3
+ [Github](https://github.com/RichardErkhov)
4
+
5
+ [Discord](https://discord.gg/pvy7H8DZMG)
6
+
7
+ [Request more models](https://github.com/RichardErkhov/quant_request)
8
+
9
+
10
+ bloom-7b1 - GGUF
11
+ - Model creator: https://huggingface.co/bigscience/
12
+ - Original model: https://huggingface.co/bigscience/bloom-7b1/
13
+
14
+
15
+ | Name | Quant method | Size |
16
+ | ---- | ---- | ---- |
17
+ | [bloom-7b1.Q2_K.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q2_K.gguf) | Q2_K | 3.2GB |
18
+ | [bloom-7b1.IQ3_XS.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.IQ3_XS.gguf) | IQ3_XS | 3.56GB |
19
+ | [bloom-7b1.IQ3_S.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.IQ3_S.gguf) | IQ3_S | 3.63GB |
20
+ | [bloom-7b1.Q3_K_S.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q3_K_S.gguf) | Q3_K_S | 3.63GB |
21
+ | [bloom-7b1.IQ3_M.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.IQ3_M.gguf) | IQ3_M | 1.2GB |
22
+ | [bloom-7b1.Q3_K.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q3_K.gguf) | Q3_K | 0.99GB |
23
+ | [bloom-7b1.Q3_K_M.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q3_K_M.gguf) | Q3_K_M | 0.63GB |
24
+ | [bloom-7b1.Q3_K_L.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q3_K_L.gguf) | Q3_K_L | 0.52GB |
25
+ | [bloom-7b1.IQ4_XS.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.IQ4_XS.gguf) | IQ4_XS | 0.23GB |
26
+ | [bloom-7b1.Q4_0.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q4_0.gguf) | Q4_0 | 0.19GB |
27
+ | [bloom-7b1.IQ4_NL.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.IQ4_NL.gguf) | IQ4_NL | 0.06GB |
28
+ | [bloom-7b1.Q4_K_S.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q4_K_S.gguf) | Q4_K_S | 0.06GB |
29
+ | [bloom-7b1.Q4_K.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q4_K.gguf) | Q4_K | 0.06GB |
30
+ | [bloom-7b1.Q4_K_M.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q4_K_M.gguf) | Q4_K_M | 0.02GB |
31
+ | [bloom-7b1.Q4_1.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q4_1.gguf) | Q4_1 | 0.01GB |
32
+ | [bloom-7b1.Q5_0.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q5_0.gguf) | Q5_0 | 0.0GB |
33
+ | [bloom-7b1.Q5_K_S.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q5_K_S.gguf) | Q5_K_S | 0.0GB |
34
+ | [bloom-7b1.Q5_K.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q5_K.gguf) | Q5_K | 0.0GB |
35
+ | [bloom-7b1.Q5_K_M.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q5_K_M.gguf) | Q5_K_M | 0.0GB |
36
+ | [bloom-7b1.Q5_1.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q5_1.gguf) | Q5_1 | 0.0GB |
37
+ | [bloom-7b1.Q6_K.gguf](https://huggingface.co/RichardErkhov/bigscience_-_bloom-7b1-gguf/blob/main/bloom-7b1.Q6_K.gguf) | Q6_K | 0.0GB |
38
+
39
+
40
+
41
+
42
+ Original model description:
43
+ ---
44
+ license: bigscience-bloom-rail-1.0
45
+ language:
46
+ - ak
47
+ - ar
48
+ - as
49
+ - bm
50
+ - bn
51
+ - ca
52
+ - code
53
+ - en
54
+ - es
55
+ - eu
56
+ - fon
57
+ - fr
58
+ - gu
59
+ - hi
60
+ - id
61
+ - ig
62
+ - ki
63
+ - kn
64
+ - lg
65
+ - ln
66
+ - ml
67
+ - mr
68
+ - ne
69
+ - nso
70
+ - ny
71
+ - or
72
+ - pa
73
+ - pt
74
+ - rn
75
+ - rw
76
+ - sn
77
+ - st
78
+ - sw
79
+ - ta
80
+ - te
81
+ - tn
82
+ - ts
83
+ - tum
84
+ - tw
85
+ - ur
86
+ - vi
87
+ - wo
88
+ - xh
89
+ - yo
90
+ - zh
91
+ - zhs
92
+ - zht
93
+ - zu
94
+ pipeline_tag: text-generation
95
+ ---
96
+
97
+ <h1 style='text-align: center '>BLOOM LM</h1>
98
+ <h2 style='text-align: center '><em>BigScience Large Open-science Open-access Multilingual Language Model</em> </h2>
99
+ <h3 style='text-align: center '>Model Card</h3>
100
+ <img src="https://aeiljuispo.cloudimg.io/v7/https://cdn-uploads.huggingface.co/production/uploads/1634806038075-5df7e9e5da6d0311fd3d53f9.png" alt="BigScience Logo" width="800" style="margin-left:auto; margin-right:auto; display:block"/>
101
+
102
+
103
+ Version 1.0 / 26.May.2022
104
+
105
+ ## Table of Contents
106
+ 1. [Model Details](#model-details)
107
+ 2. [Uses](#uses)
108
+ 3. [Training Data](#training-data)
109
+ 4. [Risks and Limitations](#risks-and-limitations)
110
+ 5. [Evaluation](#evaluation)
111
+ 6. [Recommendations](#recommendations)
112
+ 7. [Glossary and Calculations](#glossary-and-calculations)
113
+ 8. [More Information](#more-information)
114
+ 9. [Model Card Authors](#model-card-authors)
115
+
116
+ ## Model Details
117
+
118
+ ### Basics
119
+ *This section provides information for anyone who wants to know about the model.*
120
+
121
+ <details>
122
+ <summary>Click to expand</summary> <br/>
123
+
124
+ **Developed by:** BigScience ([website](https://bigscience.huggingface.co))
125
+
126
+ * All collaborators are either volunteers or have an agreement with their employer. *(Further breakdown of participants forthcoming.)*
127
+
128
+ **Model Type:** Transformer-based Language Model
129
+
130
+ **Version:** 1.0.0
131
+
132
+ **Languages:** Multiple; see [training data](#training-data)
133
+
134
+ **License:** RAIL License v1.0 ([link](https://huggingface.co/spaces/bigscience/license))
135
+
136
+ **Release Date Estimate:** Monday, 11.July.2022
137
+
138
+ **Send Questions to:** bigscience-contact@googlegroups.com
139
+
140
+ **Cite as:** BigScience, _BigScience Language Open-science Open-access Multilingual (BLOOM) Language Model_. International, May 2021-May 2022
141
+
142
+ **Funded by:**
143
+
144
+ * The French government.
145
+
146
+ * Hugging Face ([website](https://huggingface.co)).
147
+
148
+ * Organizations of contributors. *(Further breakdown of organizations forthcoming.)*
149
+
150
+ </details>
151
+
152
+ ### Technical Specifications
153
+ *This section provides information for people who work on model development.*
154
+
155
+ <details>
156
+ <summary>Click to expand</summary><br/>
157
+
158
+ Please see [the BLOOM training README](https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml#readme) for full details on replicating training.
159
+
160
+ **Model Architecture:** Modified from Megatron-LM GPT2 (see [paper](https://arxiv.org/abs/1909.08053), [BLOOM Megatron code](https://github.com/bigscience-workshop/Megatron-DeepSpeed)):
161
+
162
+ * Decoder-only architecture
163
+
164
+ * Layer normalization applied to word embeddings layer (`StableEmbedding`; see [code](https://github.com/facebookresearch/bitsandbytes), [paper](https://arxiv.org/pdf/2110.02861.pdf))
165
+
166
+ * ALiBI positional encodings (see [paper](https://arxiv.org/pdf/2108.12409.pdf)), with GeLU activation functions
167
+
168
+ * 7,069,016,064 parameters:
169
+
170
+ * 1,027,604,480 embedding parameters
171
+
172
+ * 30 layers, 32 attention heads
173
+
174
+ * Hidden layers are 4096-dimensional
175
+
176
+ * Sequence length of 2048 tokens used (see [BLOOM tokenizer](https://huggingface.co/bigscience/tokenizer), [tokenizer description](#tokenization))
177
+
178
+ **Objective Function:** Cross Entropy with mean reduction (see [API documentation](https://pytorch.org/docs/stable/generated/torch.nn.CrossEntropyLoss.html#torch.nn.CrossEntropyLoss)).
179
+
180
+ **Compute infrastructure:** Jean Zay Public Supercomputer, provided by the French government (see [announcement](https://www.enseignementsup-recherche.gouv.fr/fr/signature-du-marche-d-acquisition-de-l-un-des-supercalculateurs-les-plus-puissants-d-europe-46733)).
181
+
182
+ * Hardware: 384 A100 80GB GPUs (48 nodes):
183
+
184
+ * Additional 32 A100 80GB GPUs (4 nodes) in reserve
185
+
186
+ * 8 GPUs per node Using NVLink 4 inter-gpu connects, 4 OmniPath links
187
+
188
+ * CPU: AMD
189
+
190
+ * CPU memory: 512GB per node
191
+
192
+ * GPU memory: 640GB per node
193
+
194
+ * Inter-node connect: Omni-Path Architecture (OPA)
195
+
196
+ * NCCL-communications network: a fully dedicated subnet
197
+
198
+ * Disc IO network: shared network with other types of nodes
199
+
200
+ * Software:
201
+
202
+ * Megatron-DeepSpeed ([Github link](https://github.com/bigscience-workshop/Megatron-DeepSpeed))
203
+
204
+ * DeepSpeed ([Github link](https://github.com/microsoft/DeepSpeed))
205
+
206
+ * PyTorch (pytorch-1.11 w/ CUDA-11.5; see [Github link](https://github.com/pytorch/pytorch))
207
+
208
+ * apex ([Github link](https://github.com/NVIDIA/apex))
209
+
210
+
211
+ #### **Training**
212
+
213
+
214
+ Training logs: [Tensorboard link](https://huggingface.co/tensorboard/bigscience/tr11c-2B5-logs)
215
+
216
+ - Number of epochs: 1 (*current target*)
217
+
218
+ - Dates:
219
+
220
+ - Started 11th March, 2022 11:42am PST
221
+
222
+ - Ended 5th July, 2022
223
+
224
+ - Estimated cost of training: Equivalent of $2-5M in cloud computing (including preliminary experiments)
225
+
226
+ - Server training location: Île-de-France, France
227
+
228
+ #### **Tokenization**
229
+
230
+ The BLOOM tokenizer ([link](https://huggingface.co/bigscience/tokenizer)) is a learned subword tokenizer trained using:
231
+
232
+ - A byte-level Byte Pair Encoding (BPE) algorithm
233
+
234
+ - A simple pre-tokenization rule, no normalization
235
+
236
+ - A vocabulary size of 250,680
237
+
238
+ It was trained on a subset of a preliminary version of the corpus using alpha-weighting per language.
239
+
240
+ </details>
241
+
242
+
243
+ ### Environmental Impact
244
+
245
+ <details>
246
+ <summary>Click to expand</summary><br/>
247
+
248
+ The training supercomputer, Jean Zay ([website](http://www.idris.fr/eng/jean-zay/jean-zay-presentation-eng.html)), uses mostly nuclear energy. The heat generated by it is reused for heating campus housing.
249
+
250
+ **Estimated carbon emissions:** *(Forthcoming upon completion of training.)*
251
+
252
+ **Estimated electricity usage:** *(Forthcoming upon completion of training.)*
253
+
254
+
255
+ </details>
256
+ <p>&nbsp;</p>
257
+
258
+ ## Uses
259
+
260
+ *This section addresses questions around how the model is intended to be used, discusses the foreseeable users of the model (including those affected by the model), and describes uses that are considered out of scope or misuse of the model.
261
+ It provides information for anyone considering using the model or who is affected by the model.*
262
+
263
+
264
+ <details>
265
+ <summary>Click to expand</summary><br/>
266
+
267
+ ### Intended Use
268
+
269
+ This model is being created in order to enable public research on large language models (LLMs). LLMs are intended to be used for language generation or as a pretrained base model that can be further fine-tuned for specific tasks. Use cases below are not exhaustive.
270
+
271
+ #### **Direct Use**
272
+
273
+ - Text generation
274
+
275
+ - Exploring characteristics of language generated by a language model
276
+
277
+ - Examples: Cloze tests, counterfactuals, generations with reframings
278
+
279
+ #### **Downstream Use**
280
+
281
+ - Tasks that leverage language models include: Information Extraction, Question Answering, Summarization
282
+
283
+ ### Misuse and Out-of-scope Use
284
+ *This section addresses what users ought not do with the model.*
285
+
286
+ See the [BLOOM License](https://huggingface.co/spaces/bigscience/license), Attachment A, for detailed usage restrictions. The below list is non-exhaustive, but lists some easily foreseeable problematic use cases.
287
+
288
+ #### **Out-of-scope Uses**
289
+
290
+ Using the model in [high-stakes](#high-stakes) settings is out of scope for this model.  The model is not designed for [critical decisions](#critical-decisions) nor uses with any material consequences on an individual's livelihood or wellbeing. The model outputs content that appears factual but is not correct.
291
+
292
+ ##### Out-of-scope Uses Include:
293
+
294
+ - Usage in biomedical domains, political and legal domains, or finance domains
295
+
296
+ - Usage for evaluating or scoring individuals, such as for employment, education, or credit
297
+
298
+ - Applying the model for critical automatic decisions, generating factual content, creating reliable summaries, or generating predictions that must be correct
299
+
300
+ #### **Misuse**
301
+
302
+ Intentionally using the model for harm, violating [human rights](#human-rights), or other kinds of malicious activities, is a misuse of this model. This includes:
303
+
304
+ - Spam generation
305
+
306
+ - Disinformation and influence operations
307
+
308
+ - Disparagement and defamation
309
+
310
+ - Harassment and abuse
311
+
312
+ - [Deception](#deception)
313
+
314
+ - Unconsented impersonation and imitation
315
+
316
+ - Unconsented surveillance
317
+
318
+ - Generating content without attribution to the model, as specified in the [RAIL License, Use Restrictions](https://huggingface.co/spaces/bigscience/license)
319
+
320
+ ### Intended Users
321
+
322
+ #### **Direct Users**
323
+
324
+ - General Public
325
+
326
+ - Researchers
327
+
328
+ - Students
329
+
330
+ - Educators
331
+
332
+ - Engineers/developers
333
+
334
+ - Non-commercial entities
335
+
336
+ - Community advocates, including human and civil rights groups
337
+
338
+ #### Indirect Users
339
+
340
+ - Users of derivatives created by Direct Users, such as those using software with an [intended use](#intended-use)
341
+
342
+ - Users of [Derivatives of the Model, as described in the License](https://huggingface.co/spaces/bigscience/license)
343
+
344
+ #### Others Affected (Parties Prenantes)
345
+
346
+ - People and groups referred to by the LLM
347
+
348
+ - People and groups exposed to outputs of, or decisions based on, the LLM
349
+
350
+ - People and groups whose original work is included in the LLM
351
+
352
+ </details>
353
+ <p>&nbsp;</p>
354
+
355
+ ## Training Data
356
+ *This section provides a high-level overview of the training data. It is relevant for anyone who wants to know the basics of what the model is learning.*
357
+
358
+
359
+ <details>
360
+ <summary>Click to expand</summary><br/>
361
+
362
+ Details for each dataset are provided in individual [Data Cards](https://huggingface.co/spaces/bigscience/BigScienceCorpus).
363
+
364
+ Training data includes:
365
+
366
+ - 45 natural languages
367
+
368
+ - 12 programming languages
369
+
370
+ - In 1.5TB of pre-processed text, converted into 350B unique tokens (see [the tokenizer section](#tokenization) for more.)
371
+
372
+
373
+ #### **Languages**
374
+
375
+ The pie chart shows the distribution of languages in training data.
376
+
377
+ ![pie chart showing the distribution of languages in training data](https://github.com/bigscience-workshop/model_card/blob/main/assets/data/pie_chart.svg?raw=true)
378
+
379
+
380
+ The following table shows the further distribution of Niger-Congo and Indic languages in the training data.
381
+ <details>
382
+ <summary>Click to expand</summary><br/>
383
+
384
+ | Niger Congo | Percentage | | Indic | Percentage |
385
+ |----------------|------------ |------ |-----------|------------|
386
+ | Chi Tumbuka | 0.00002 | | Assamese | 0.01 |
387
+ | Kikuyu | 0.00004 | | Odia | 0.04 |
388
+ | Bambara | 0.00004 | | Gujarati | 0.04 |
389
+ | Akan | 0.00007 | | Marathi | 0.05 |
390
+ | Xitsonga | 0.00007 | | Punjabi | 0.05 |
391
+ | Sesotho | 0.00007 | | Kannada | 0.06 |
392
+ | Chi Chewa | 0.0001 | | Nepali | 0.07 |
393
+ | Setswana | 0.0002 | | Telugu | 0.09 |
394
+ | Northern Sotho | 0.0002 | | Malayalam | 0.10 |
395
+ | Fon | 0.0002 | | Urdu | 0.10 |
396
+ | Kirundi | 0.0003 | | Tamil | 0.20 |
397
+ | Wolof | 0.0004 | | Bengali | 0.50 |
398
+ | Kuganda | 0.0004 | | Hindi | 0.70 |
399
+ | Chi Shona | 0.001 |
400
+ | Isi Zulu | 0.001 |
401
+ | Igbo | 0.001 |
402
+ | Xhosa | 0.001 |
403
+ | Kinyarwanda | 0.003 |
404
+ | Yoruba | 0.006 |
405
+ | Swahili | 0.02 |
406
+ </details>
407
+
408
+ The following table shows the distribution of programming languages.
409
+ <details>
410
+ <summary>Click to expand</summary><br/>
411
+
412
+ | Extension | Language | Number of files |
413
+ |----------------|------------|-----------------|
414
+ | java | Java | 5,407,724 |
415
+ | php | PHP | 4,942,186 |
416
+ | cpp | C++ | 2,503,930 |
417
+ | py | Python | 2,435,072 |
418
+ | js | JavaScript | 1,905,518 |
419
+ | cs | C# | 1,577,347 |
420
+ | rb | Ruby | 6,78,413 |
421
+ | cc | C++ | 443,054 |
422
+ | hpp | C++ | 391,048 |
423
+ | lua | Lua | 352,317 |
424
+ | go | GO | 227,763 |
425
+ | ts | TypeScript | 195,254 |
426
+ | C | C | 134,537 |
427
+ | scala | Scala | 92,052 |
428
+ | hh | C++ | 67,161 |
429
+ | H | C++ | 55,899 |
430
+ | tsx | TypeScript | 33,107 |
431
+ | rs | Rust | 29,693 |
432
+ | phpt | PHP | 9,702 |
433
+ | c++ | C++ | 1,342 |
434
+ | h++ | C++ | 791 |
435
+ | php3 | PHP | 540 |
436
+ | phps | PHP | 270 |
437
+ | php5 | PHP | 166 |
438
+ | php4 | PHP | 29 |
439
+
440
+ </details>
441
+ </details>
442
+ <p>&nbsp;</p>
443
+
444
+ ## Risks and Limitations
445
+ *This section identifies foreseeable harms and misunderstandings.*
446
+
447
+ <details>
448
+ <summary>Click to expand</summary><br/>
449
+
450
+ Model may:
451
+
452
+ - Overrepresent some viewpoints and underrepresent others
453
+
454
+ - Contain stereotypes
455
+
456
+ - Contain [personal information](#personal-data-and-information)
457
+
458
+ - Generate:
459
+
460
+ - Hateful, abusive, or violent language
461
+
462
+ - Discriminatory or prejudicial language
463
+
464
+ - Content that may not be appropriate for all settings, including sexual content
465
+
466
+ - Make errors, including producing incorrect information as if it were factual
467
+
468
+ - Generate irrelevant or repetitive outputs
469
+ </details>
470
+ <p>&nbsp;</p>
471
+
472
+ ## Evaluation
473
+ *This section describes the evaluation protocols and provides the results.*
474
+
475
+ <details>
476
+ <summary>Click to expand</summary><br/>
477
+
478
+ ### Metrics
479
+ *This section describes the different ways performance is calculated and why.*
480
+
481
+ Includes:
482
+
483
+ | Metric | Why chosen |
484
+ |--------------------|--------------------------------------------------------------------|
485
+ | [Perplexity](#perplexity) | Standard metric for quantifying model improvements during training |
486
+ | Cross Entropy [Loss](#loss) | Standard objective for language models. |
487
+
488
+ And multiple different metrics for specific tasks. _(More evaluation metrics forthcoming upon completion of evaluation protocol.)_
489
+
490
+ ### Factors
491
+ *This section lists some different aspects of BLOOM models. Its focus is on those aspects that are likely to give rise to high variance in model behavior.*
492
+
493
+ - Language, such as English or Yoruba
494
+
495
+ - Domain, such as newswire or stories
496
+
497
+ - Demographic characteristics, such as gender or nationality
498
+
499
+ ### Results
500
+ *Results are based on the [Factors](#factors) and [Metrics](#metrics).*
501
+
502
+ **Train-time Evaluation:**
503
+
504
+ As of 25.May.2022, 15:00 PST:
505
+
506
+ - Training Loss: 2.3
507
+
508
+ - Validation Loss: 2.9
509
+
510
+ - Perplexity: 16
511
+
512
+ </details>
513
+ <p>&nbsp;</p>
514
+
515
+ ## Recommendations
516
+
517
+ *This section provides information on warnings and potential mitigations.*
518
+
519
+
520
+ <details>
521
+ <summary>Click to expand</summary><br/>
522
+
523
+ - Indirect users should be made aware when the content they're working with is created by the LLM.
524
+
525
+ - Users should be aware of [Risks and Limitations](#risks-and-limitations), and include an appropriate age disclaimer or blocking interface as necessary.
526
+
527
+ - Models pretrained with the LLM should include an updated Model Card.
528
+
529
+ - Users of the model should provide mechanisms for those affected to provide feedback, such as an email address for comments.
530
+
531
+ </details>
532
+ <p>&nbsp;</p>
533
+
534
+ ## Glossary and Calculations
535
+
536
+ *This section defines common terms and how metrics are calculated.*
537
+
538
+
539
+
540
+ <details>
541
+ <summary>Click to expand</summary><br/>
542
+
543
+ - <a name="loss">**Loss:**</a> A calculation of the difference between what the model has learned and what the data shows ("groundtruth"). The lower the loss, the better. The training process aims to minimize the loss.
544
+
545
+ - <a name="perplexity">**Perplexity:**</a> This is based on what the model estimates the probability of new data is. The lower the perplexity, the better. If the model is 100% correct at predicting the next token it will see, then the perplexity is 1. Mathematically this is calculated using entropy.
546
+
547
+ - <a name="high-stakes">**High-stakes settings:**</a> Such as those identified as "high-risk AI systems" and "unacceptable risk AI systems" in the European Union's proposed [Artificial Intelligence (AI) Act](https://artificialintelligenceact.eu/annexes/).
548
+
549
+ - <a name="critical-decisions">**Critical decisions:**</a> Such as those defined in [the United States' proposed Algorithmic Accountability Act](https://www.congress.gov/117/bills/s3572/BILLS-117s3572is.pdf).
550
+
551
+ - <a name="human-rights">**Human rights:**</a> Includes those rights defined in the [Universal Declaration of Human Rights](https://www.un.org/sites/un2.un.org/files/2021/03/udhr.pdf).
552
+
553
+ - <a name="personal-data-and-information">**Personal Data and Personal Information:**</a> Personal data and information is defined in multiple data protection regulations, such as "[personal data](https://gdpr-info.eu/issues/personal-data/)" in the [European Union's General Data Protection Regulation](https://gdpr-info.eu); and "personal information" in the Republic of South Africa's [Protection of Personal Information Act](https://www.gov.za/sites/default/files/gcis_document/201409/3706726-11act4of2013popi.pdf), The People's Republic of China's [Personal information protection law](http://en.npc.gov.cn.cdurl.cn/2021-12/29/c_694559.htm).
554
+
555
+ - <a name="sensitive-characteristics">**Sensitive characteristics:**</a> This includes specifically protected categories in human rights (see [UHDR, Article 2](https://www.un.org/sites/un2.un.org/files/2021/03/udhr.pdf)) and personal information regulation (see GDPR, [Article 9; Protection of Personal Information Act, Chapter 1](https://www.gov.za/sites/default/files/gcis_document/201409/3706726-11act4of2013popi.pdf))
556
+
557
+ - <a name="deception">**Deception:**</a> Doing something to intentionally mislead individuals to believe something that is false, such as by creating deadbots or chatbots on social media posing as real people, or generating text documents without making consumers aware that the text is machine generated.
558
+
559
+ </details>
560
+ <p>&nbsp;</p>
561
+
562
+ ## More Information
563
+
564
+ <details>
565
+ <summary>Click to expand</summary><br/>
566
+
567
+ ### Dataset Creation
568
+
569
+ Blog post detailing the design choices during the dataset creation: https://bigscience.huggingface.co/blog/building-a-tb-scale-multilingual-dataset-for-language-modeling
570
+
571
+ ### Technical Specifications
572
+
573
+ Blog post summarizing how the architecture, size, shape, and pre-training duration where selected: https://bigscience.huggingface.co/blog/what-language-model-to-train-if-you-have-two-million-gpu-hours
574
+
575
+ More details on the architecture/optimizer: https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml
576
+
577
+ Blog post on the hardware/engineering side: https://bigscience.huggingface.co/blog/which-hardware-to-train-a-176b-parameters-model
578
+
579
+ Details on the distributed setup used for the training: https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml
580
+
581
+ Tensorboard updated during the training: https://huggingface.co/bigscience/tr11-176B-ml-logs/tensorboard#scalars&tagFilter=loss
582
+
583
+ Insights on how to approach training, negative results: https://github.com/bigscience-workshop/bigscience/blob/master/train/lessons-learned.md
584
+
585
+ Details on the obstacles overcome during the preparation on the engineering side (instabilities, optimization of training throughput, so many technical tricks and questions): https://github.com/bigscience-workshop/bigscience/blob/master/train/tr11-176B-ml/chronicles.md
586
+
587
+ ### Initial Results
588
+
589
+ Initial prompting experiments using interim checkpoints: https://huggingface.co/spaces/bigscience/bloom-book
590
+
591
+ </details>
592
+ <p>&nbsp;</p>
593
+
594
+ ## Model Card Authors
595
+ *Ordered roughly chronologically and by amount of time spent.*
596
+
597
+ Margaret Mitchell, Giada Pistilli, Yacine Jernite, Ezinwanne Ozoani, Marissa Gerchick, Nazneen Rajani, Sasha Luccioni, Irene Solaiman, Maraim Masoud, Somaieh Nikpoor, Carlos Muñoz Ferrandis, Stas Bekman, Christopher Akiki, Danish Contractor, David Lansky, Angelina McMillan-Major, Tristan Thrush, Suzana Ilić, Gérard Dupont, Shayne Longpre, Manan Dey, Stella Biderman, Douwe Kiela, Emi Baylor, Teven Le Scao, Aaron Gokaslan, Julien Launay, Niklas Muennighoff
598
+
599
+
600
+