Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imgarylai/bert-embedding
🔡 Token level embeddings from BERT model on mxnet and gluonnlp
https://github.com/imgarylai/bert-embedding
bert gluonnlp mxnet natural-language-processing nlp word-embeddings
Last synced: about 2 months ago
JSON representation
🔡 Token level embeddings from BERT model on mxnet and gluonnlp
- Host: GitHub
- URL: https://github.com/imgarylai/bert-embedding
- Owner: imgarylai
- License: apache-2.0
- Archived: true
- Created: 2019-02-08T13:52:38.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-11-13T04:30:57.000Z (almost 5 years ago)
- Last Synced: 2024-07-13T03:46:34.069Z (2 months ago)
- Topics: bert, gluonnlp, mxnet, natural-language-processing, nlp, word-embeddings
- Language: Python
- Homepage: http://bert-embedding.readthedocs.io/
- Size: 120 KB
- Stars: 449
- Watchers: 9
- Forks: 68
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-bert - imgarylai/bert-embedding - embedding.readthedocs.io/, (BERT language model and embedding:)
- Awesome-MXNet - **BERT-embedding**
README
# Bert Embeddings
### [Deprecated] Thank you for checking this project. Unfortunately, I don't have time to maintain this project anymore. If you are interested in maintaing this project. Please create an issue and let me know.
[](https://travis-ci.org/imgarylai/bert-embedding) [](https://codecov.io/gh/imgarylai/bert-embedding) [](https://pypi.org/project/bert-embedding/) [](https://bert-embedding.readthedocs.io/en/latest/?badge=latest)
[BERT](https://arxiv.org/abs/1810.04805), published by [Google](https://github.com/google-research/bert), is new way to obtain pre-trained language model word representation. Many NLP tasks are benefit from BERT to get the SOTA.
The goal of this project is to obtain the token embedding from BERT's pre-trained model. In this way, instead of building and do fine-tuning for an end-to-end NLP model, you can build your model by just utilizing or token embedding.
This project is implemented with [@MXNet](https://github.com/apache/incubator-mxnet). Special thanks to [@gluon-nlp](https://github.com/dmlc/gluon-nlp) team.
## Install
```
pip install bert-embedding
# If you want to run on GPU machine, please install `mxnet-cu92`.
pip install mxnet-cu92
```
## Usage
```python
from bert_embedding import BertEmbedding
bert_abstract = """We introduce a new language representation model called BERT, which stands for Bidirectional Encoder Representations from Transformers.
Unlike recent language representation models, BERT is designed to pre-train deep bidirectional representations by jointly conditioning on both left and right context in all layers.
As a result, the pre-trained BERT representations can be fine-tuned with just one additional output layer to create state-of-the-art models for a wide range of tasks, such as question answering and language inference, without substantial task-specific architecture modifications.
BERT is conceptually simple and empirically powerful.
It obtains new state-of-the-art results on eleven natural language processing tasks, including pushing the GLUE benchmark to 80.4% (7.6% absolute improvement), MultiNLI accuracy to 86.7 (5.6% absolute improvement) and the SQuAD v1.1 question answering Test F1 to 93.2 (1.5% absolute improvement), outperforming human performance by 2.0%."""
sentences = bert_abstract.split('\n')
bert_embedding = BertEmbedding()
result = bert_embedding(sentences)
```
If you want to use GPU, please import mxnet and set context
```python
import mxnet as mx
from bert_embedding import BertEmbedding
...
ctx = mx.gpu(0)
bert = BertEmbedding(ctx=ctx)
```
This result is a list of a tuple containing (tokens, tokens embedding)
For example:
```python
first_sentence = result[0]
first_sentence[0]
# ['we', 'introduce', 'a', 'new', 'language', 'representation', 'model', 'called', 'bert', ',', 'which', 'stands', 'for', 'bidirectional', 'encoder', 'representations', 'from', 'transformers']
len(first_sentence[0])
# 18
len(first_sentence[1])
# 18
first_token_in_first_sentence = first_sentence[1]
first_token_in_first_sentence[1]
# array([ 0.4805648 , 0.18369392, -0.28554988, ..., -0.01961522,
# 1.0207764 , -0.67167974], dtype=float32)
first_token_in_first_sentence[1].shape
# (768,)
```
## OOV
There are three ways to handle oov, avg (default), sum, and last. This can be specified in encoding.
```python
...
bert_embedding = BertEmbedding()
bert_embedding(sentences, 'sum')
...
```
## Available pre-trained BERT models
| |book_corpus_wiki_en_uncased|book_corpus_wiki_en_cased|wiki_multilingual|wiki_multilingual_cased|wiki_cn|
|---|---|---|---|---|---|
|bert_12_768_12|✓|✓|✓|✓|✓|
|bert_24_1024_16|x|✓|x|x|x|
Example of using the large pre-trained BERT model from Google
```python
from bert_embedding import BertEmbedding
bert_embedding = BertEmbedding(model='bert_24_1024_16', dataset_name='book_corpus_wiki_en_cased')
```
Source: [gluonnlp](http://gluon-nlp.mxnet.io/model_zoo/bert/index.html)