GeNN
GeNN (generative neural networks) is a high-level interface for text applications using PyTorch RNN's.
Features
- Preprocessing:
- Parsing txt, json, and csv files.
- NLTK, regex and spacy tokenization support.
- GloVe and fastText pretrained embeddings, with the ability to fine-tune for your data.
- Architectures and customization:
- GPT2 with small, medium, and large variants.
- LSTM and GRU, with variable size.
- Variable number of layers and batches.
- Dropout.
- Text generation:
- Random seed sampling from the n first tokens in all instances, or the most frequent token.
- Top-K sampling for next token prediction with variable K.
- Nucleus sampling for next token prediction with variable probability threshold.
- Text Summarization:
- All GPT2 variants can be trained to perform text summarization.
Getting started
How to install
pip install genn
Prerequisites
- PyTorch 1.4.0
pip install torch==1.4.0
- Pytorch Transformers
pip install pytorch_transformers
- NumPy
pip install numpy
- fastText
pip install fasttext
Use the package manager pip to install genn.
Usage
Text Generation:
RNNs (You can switch LSTMGenerator with GRUGenerator:
from genn import Preprocessing, LSTMGenerator, GRUGenerator
#LSTM example
ds = Preprocessing("data.txt")
gen = LSTMGenerator(ds, nLayers = 2,
batchSize = 16,
embSize = 64,
lstmSize = 16,
epochs = 20)
#Train the model
gen.run()
# Generate 5 new documents
print(gen.generate_document(5))
GPT2 Generator:
#GPT2 example
gen = GPT2("data.txt",
taskToken = "Movie:",
epochs = 7,
variant = "medium")
#Train the model
gen.run()
#Generate 10 new documents
print(gen.generate_document(10))
Text Summarization:
GPT2 Summarizer:
#GPT2 Summarizer example
from genn import GPT2Summarizer
summ = GPT2Summarizer("data.txt",
epochs=3,
batch_size=8)
#Train the model
summ.run()
#Create 5 summaries of a source document
src_doc = "This is the source document to summarize"
print(summ.summarize_document(n=5, setSeed = src_doc))
For more examples on how to use Preprocessing, please refer to this file.
For more examples on how to use LSTMGenerator and GRUGenerator, please refer to this file.
For more examples on how to use GPT2, please refer to this file.
For more examples on how to use GPT2Summarizer, please refer to this file.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
License
Distributed under the MIT License. See LICENSE for more information.
2 maintainers
Metadata
2 maintainers
Release files for abdoTheBest 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| abdoTheBest-1.0.0.tar.gz | 17.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| abdoTheBest-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.5 kB
Release files / abdoTheBest-1.0.0.tar.gz
| Download URL | abdoTheBest-1.0.0.tar.gz |
|---|---|
| Size | 17.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09045c6090bfe1b1e4b4fa4a309a973500ef64637c63e0d0d1b460671b267613
|
|
BLAKE2b-256 checksum How to use checksums |
55f3d948dfe7af193ea36a74b27f94c2c6d0490a6573a833982e13f3c207df03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.7
|
Release files / abdoTheBest-1.0.0-py3-none-any.whl
| Download URL | abdoTheBest-1.0.0-py3-none-any.whl |
|---|---|
| Size | 21.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5c3d0cb2b6cabf9945b303ffdedc05bc3ba9541e7f0892042a8d7c1c43be15cf
|
|
BLAKE2b-256 checksum How to use checksums |
96bc7c9735f4517e0ea73cfbe12c107398ae94742254822ba53bf5462a20d167
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.8.7
|
