Home

Awesome


license: bigscience-bloom-rail-1.0 language:


DEPRECATED. This is now live at https://huggingface.co/bigscience/bloom . Please make additional changes there!

<p>BLOOM LM<br/> BigScience Large Open-science Open-access Multilingual Language Model <br/>Model Card</p>

<img src="https://assets.website-files.com/6139f3cdcbbff3a68486761d/613cd8997b270da063e230c5_Tekengebied%201-p-500.png" alt="BigScience Logo" width="200"/>

Version 1.0 / 25.May.2022

Table of Contents

  1. Model Details
  2. Uses
  3. Training Data
  4. Risks and Limitations
  5. Evaluation
  6. Recommendations
  7. Glossary and Calculations
  8. More Information
  9. Model Card Authors

Model Details

Basics

This section provides information for anyone who wants to know about the model.

<details> <summary>Click to expand</summary> <br/>

Developed by: BigScience (website)

Model Type: Transformer-based Language Model

Version: 1.0.0

Languages: Multiple; see training data

License: RAIL License v1.0 (link)

Release Date Estimate: Monday, 11.July.2022

Send Questions to: bigscience-contact@googlegroups.com

Cite as: BigScience, BigScience Language Open-source Open-access Multilingual (BLOOM) Language Model. International, May 2021-May 2022

Funded by:

</details>

Technical Specifications

This section provides information for people who work on model development.

<details> <summary>Click to expand</summary><br/>

Please see the BLOOM training README for full details on replicating training.

Model Architecture: Modified from Megatron-LM GPT2 (see paper, BLOOM Megatron code):

Objective Function: Cross Entropy with mean reduction (see API documentation).

Compute infrastructure: Jean Zay Public Supercomputer, provided by the French government (see announcement).

Training

In progress.

Tokenization

The BLOOM tokenizer (link) is a learned subword tokenizer trained using:

It was trained on a subset of a preliminary version of the corpus using alpha-weighting per language.

</details>

Environmental Impact

<details> <summary>Click to expand</summary><br/>

The training supercomputer, Jean Zay (website), uses mostly nuclear energy. The heat generated by it is reused for heating campus housing.

Estimated carbon emissions: (Forthcoming upon completion of training.)

Estimated electricity usage: (Forthcoming upon completion of training.)

</details> <p>&nbsp;</p>

Uses

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. It provides information for anyone considering using the model or who is affected by the model.

<details> <summary>Click to expand</summary><br/>

Intended Use

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.

Direct Use

Downstream Use

Misuse and Out-of-scope Use

This section addresses what users ought not do with the model.

See the BLOOM License, Attachment A, for detailed usage restrictions. The below list is non-exhaustive, but lists some easily foreseeable problematic use cases.

Out-of-scope Uses

Using the model in high-stakes settings is out of scope for this model.  The model is not designed for 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.

Out-of-scope Uses Include:

Misuse

Intentionally using the model for harm, violating human rights, or other kinds of malicious activities, is a misuse of this model. This includes:

Intended Users

Direct Users

Indirect Users

Others Affected (Parties Prenantes)

</details> <p>&nbsp;</p>

Training Data

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.

<details> <summary>Click to expand</summary><br/>

Details for each dataset are provided in individual Data Cards.

Training data includes:

Languages

The pie chart shows the distribution of languages in training data.

pie chart showing the distribution of languages in training data

The following table shows the further distribution of Niger-Congo and Indic languages in the training data.

<details> <summary>Click to expand</summary><br/>
Niger CongoPercentageIndicPercentage
Chi Tumbuka0.00002Assamese0.01
Kikuyu0.00004Odia0.04
Bambara0.00004Gujarati0.04
Akan0.00007Marathi0.05
Xitsonga0.00007Punjabi0.05
Sesotho0.00007Kannada0.06
Chi Chewa0.0001Nepali0.07
Setswana0.0002Telugu0.09
Northern Sotho0.0002Malayalam0.10
Fon0.0002Urdu0.10
Kirundi0.0003Tamil0.20
Wolof0.0004Bengali0.50
Kuganda0.0004Hindi0.70
Chi Shona0.001
Isi Zulu0.001
Igbo0.001
Xhosa0.001
Kinyarwanda0.003
Yoruba0.006
Swahili0.02
</details>

The following table shows the distribution of programming languages.

<details> <summary>Click to expand</summary><br/>
ExtensionLanguageNumber of files
javaJava5,407,724
phpPHP4,942,186
cppC++2,503,930
pyPython2,435,072
jsJavaScript1,905,518
csC#1,577,347
rbRuby6,78,413
ccC++443,054
hppC++391,048
luaLua352,317
goGO227,763
tsTypeScript195,254
CC134,537
scalaScala92,052
hhC++67,161
HC++55,899
tsxTypeScript33,107
rsRust29,693
phptPHP9,702
c++C++1,342
h++C++791
php3PHP540
phpsPHP270
php5PHP166
php4PHP29
</details> </details> <p>&nbsp;</p>

Risks and Limitations

This section identifies foreseeable harms and misunderstandings.

<details> <summary>Click to expand</summary><br/>

Model may:

</details> <p>&nbsp;</p>

Evaluation

This section describes the evaluation protocols and provides the results.

<details> <summary>Click to expand</summary><br/>

Metrics

This section describes the different ways performance is calculated and why.

Includes:

MetricWhy chosen
PerplexityStandard metric for quantifying model improvements during training
Cross Entropy LossStandard objective for language models

And multiple different metrics for specific tasks. (More evaluation metrics forthcoming upon completion of evaluation protocol.)

Factors

This section lists some different aspects of what BLOOM models. Its focus is on those aspects that are likely to give rise to high variance in model behavior.

Results

Results are based on the Factors and Metrics.

Train-time Evaluation:

As of 19.May.2022, 18:00:

(More evaluation scores forthcoming at the end of model training.)

</details> <p>&nbsp;</p>

Recommendations

This section provides information on warnings and potential mitigations.

<details> <summary>Click to expand</summary><br/> </details> <p>&nbsp;</p>

Glossary and Calculations

This section defines common terms and how metrics are calculated.

<details> <summary>Click to expand</summary><br/> </details> <p>&nbsp;</p>

More Information

<details> <summary>Click to expand</summary><br/>

Dataset Creation

Blog post detailing the design choices during the dataset creation: https://bigscience.huggingface.co/blog/building-a-tb-scale-multilingual-dataset-for-language-modeling

Technical Specifications

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

More details on the architecture/optimizer: https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml

Blog post on the hardware/engineering side: https://bigscience.huggingface.co/blog/which-hardware-to-train-a-176b-parameters-model

Details on the distributed setup used for the training: https://github.com/bigscience-workshop/bigscience/tree/master/train/tr11-176B-ml

Tensorboard updated during the training: https://huggingface.co/bigscience/tr11-176B-ml-logs/tensorboard#scalars&tagFilter=loss

Insights on how to approach training, negative results: https://github.com/bigscience-workshop/bigscience/blob/master/train/lessons-learned.md

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

Initial Results

Initial prompting experiments using interim checkpoints: https://huggingface.co/spaces/bigscience/bloom-book

</details> <p>&nbsp;</p>

Model Card Authors

Ordered roughly chronologically and by amount of time spent.

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, Danish Contractor, David Lansky, Angelina McMillan-Major, Tristan Thrush, Christopher Akiki, Suzana Ilić, Gérard Dupont, Shayne Longpre, Manan Dey, Stella Biderman, Douwe Kiela, Emi Baylor, Teven Le Scao, Aaron Gokaslan, Julien Launay