julien-c HF staff commited on
Commit
5536442
β€’
1 Parent(s): 9a1367c

Migrate model card from transformers-repo

Browse files

Read announcement at https://discuss.huggingface.co/t/announcement-all-model-cards-will-be-migrated-to-hf-co-model-repos/2755
Original file history: https://github.com/huggingface/transformers/commits/master/model_cards/lordtt13/emo-mobilebert/README.md

Files changed (1) hide show
  1. README.md +44 -0
README.md ADDED
@@ -0,0 +1,44 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language: en
3
+ datasets:
4
+ - emo
5
+ ---
6
+
7
+ ## Emo-MobileBERT: a thin version of BERT LARGE, trained on the EmoContext Dataset from scratch
8
+
9
+ ### Details of MobileBERT
10
+
11
+ The **MobileBERT** model was presented in [MobileBERT: a Compact Task-Agnostic BERT for Resource-Limited Devices](https://arxiv.org/abs/2004.02984) by *Zhiqing Sun, Hongkun Yu, Xiaodan Song, Renjie Liu, Yiming Yang, Denny Zhou* and here is the abstract:
12
+
13
+ Natural Language Processing (NLP) has recently achieved great success by using huge pre-trained models with hundreds of millions of parameters. However, these models suffer from heavy model sizes and high latency such that they cannot be deployed to resource-limited mobile devices. In this paper, we propose MobileBERT for compressing and accelerating the popular BERT model. Like the original BERT, MobileBERT is task-agnostic, that is, it can be generically applied to various downstream NLP tasks via simple fine-tuning. Basically, MobileBERT is a thin version of BERT_LARGE, while equipped with bottleneck structures and a carefully designed balance between self-attentions and feed-forward networks. To train MobileBERT, we first train a specially designed teacher model, an inverted-bottleneck incorporated BERT_LARGE model. Then, we conduct knowledge transfer from this teacher to MobileBERT. Empirical studies show that MobileBERT is 4.3x smaller and 5.5x faster than BERT_BASE while achieving competitive results on well-known benchmarks. On the natural language inference tasks of GLUE, MobileBERT achieves a GLUEscore o 77.7 (0.6 lower than BERT_BASE), and 62 ms latency on a Pixel 4 phone. On the SQuAD v1.1/v2.0 question answering task, MobileBERT achieves a dev F1 score of 90.0/79.2 (1.5/2.1 higher than BERT_BASE).
14
+
15
+ ### Details of the downstream task (Emotion Recognition) - Dataset πŸ“š
16
+
17
+ SemEval-2019 Task 3: EmoContext Contextual Emotion Detection in Text
18
+
19
+ In this dataset, given a textual dialogue i.e. an utterance along with two previous turns of context, the goal was to infer the underlying emotion of the utterance by choosing from four emotion classes:
20
+
21
+ - sad 😒
22
+ - happy πŸ˜ƒ
23
+ - angry 😑
24
+ - others
25
+
26
+ ### Model training
27
+
28
+ The training script is present [here](https://github.com/lordtt13/transformers-experiments/blob/master/Custom%20Tasks/emo-mobilebert.ipynb).
29
+
30
+ ### Pipelining the Model
31
+
32
+ ```python
33
+ from transformers import AutoTokenizer, AutoModelForSequenceClassification, pipeline
34
+
35
+ tokenizer = AutoTokenizer.from_pretrained("lordtt13/emo-mobilebert")
36
+
37
+ model = AutoModelForSequenceClassification.from_pretrained("lordtt13/emo-mobilebert")
38
+
39
+ nlp_sentence_classif = transformers.pipeline('sentiment-analysis', model = model, tokenizer = tokenizer)
40
+ nlp_sentence_classif("I've never had such a bad day in my life")
41
+ # Output: [{'label': 'sad', 'score': 0.93153977394104}]
42
+ ```
43
+
44
+ > Created by [Tanmay Thakur](https://github.com/lordtt13) | [LinkedIn](https://www.linkedin.com/in/tanmay-thakur-6bb5a9154/)