bert-extractive-summarizer


Namebert-extractive-summarizer JSON
Version 0.10.1 PyPI version JSON
download
home_pagehttps://github.com/dmmiller612/bert-extractive-summarizer
SummaryExtractive Text Summarization with BERT
upload_time2022-01-04 00:30:13
maintainer
docs_urlNone
authorDerek Miller
requires_python
licenseMIT
keywords bert pytorch machine learning deep learning extractive summarization summary
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Bert Extractive Summarizer

![Build Status](https://github.com/dmmiller612/bert-extractive-summarizer/actions/workflows/test.yml/badge.svg)
[![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)](https://github.com/dmmiller612/bert-extractive-summarizer)
<img src="https://img.shields.io/pypi/v/bert-extractive-summarizer.svg" />

This repo is the generalization of the lecture-summarizer repo. This tool utilizes the HuggingFace Pytorch transformers library
to run extractive summarizations. This works by first embedding the sentences, then running a clustering algorithm, finding 
the sentences that are closest to the cluster's centroids. This library also uses coreference techniques, utilizing the 
https://github.com/huggingface/neuralcoref library to resolve words in summaries that need more context. The greedyness of 
the neuralcoref library can be tweaked in the CoreferenceHandler class.

As of the most recent version of bert-extractive-summarizer, by default, CUDA is used if a gpu is available.

Paper: https://arxiv.org/abs/1906.04165

### Try the Online Demo:

[Distill Bert Summarization Demo](https://smrzr.io)

# Table of Contents
1. [Install](#install)
2. [Examples](#examples)
   1. [Simple Example](#simple-example)
   2. [SBert](#use-sbert)
   3. [Retrieve Embeddings](#retrieve-embeddings)
   4. [Use Coreference](#use-coreference)
   5. [Custom Model Example](#custom-model-example)
   6. [Large Example](#large-example)
3. [Calculating Elbow](#calculating-elbow)
4. [Running the Service](#running-the-service)

## Install

```bash
pip install bert-extractive-summarizer
```

## Examples

### Simple Example
```python
from summarizer import Summarizer

body = 'Text body that you want to summarize with BERT'
body2 = 'Something else you want to summarize with BERT'
model = Summarizer()
model(body)
model(body2)
```

#### Specifying number of sentences

Number of sentences can be supplied as a ratio or an integer. Examples are provided below.

```python
from summarizer import Summarizer
body = 'Text body that you want to summarize with BERT'
model = Summarizer()
result = model(body, ratio=0.2)  # Specified with ratio
result = model(body, num_sentences=3)  # Will return 3 sentences 
```

#### Using multiple hidden layers as the embedding output

You can also concat the summarizer embeddings for clustering. A simple example is below.

```python
from summarizer import Summarizer
body = 'Text body that you want to summarize with BERT'
model = Summarizer('distilbert-base-uncased', hidden=[-1,-2], hidden_concat=True)
result = model(body, num_sentences=3)
```

### Use SBert
One can use Sentence Bert with bert-extractive-summarizer with the newest version. It is based off the paper here:
https://arxiv.org/abs/1908.10084, and the library here: https://www.sbert.net/. To get started,
first install SBERT:

```
pip install -U sentence-transformers
```

Then a simple example is the following:

```python
from summarizer.sbert import SBertSummarizer

body = 'Text body that you want to summarize with BERT'
model = SBertSummarizer('paraphrase-MiniLM-L6-v2')
result = model(body, num_sentences=3)
```

It is worth noting that all the features that you can do with the main Summarizer class, you can also do with SBert.

### Retrieve Embeddings
You can also retrieve the embeddings of the summarization. Examples are below:

```python
from summarizer import Summarizer
body = 'Text body that you want to summarize with BERT'
model = Summarizer()
result = model.run_embeddings(body, ratio=0.2)  # Specified with ratio. 
result = model.run_embeddings(body, num_sentences=3)  # Will return (3, N) embedding numpy matrix.
result = model.run_embeddings(body, num_sentences=3, aggregate='mean')  # Will return Mean aggregate over embeddings. 
```

### Use Coreference
First ensure you have installed neuralcoref and spacy. It is worth noting that neuralcoref does not work with spacy > 0.2.1.
```bash
pip install spacy
pip install transformers # > 4.0.0
pip install neuralcoref

python -m spacy download en_core_web_md
```

Then to to use coreference, run the following:

```python
from summarizer import Summarizer
from summarizer.text_processors.coreference_handler import CoreferenceHandler

handler = CoreferenceHandler(greedyness=.4)
# How coreference works:
# >>>handler.process('''My sister has a dog. She loves him.''', min_length=2)
# ['My sister has a dog.', 'My sister loves a dog.']

body = 'Text body that you want to summarize with BERT'
body2 = 'Something else you want to summarize with BERT'
model = Summarizer(sentence_handler=handler)
model(body)
model(body2)
```

### Custom Model Example
```python
from transformers import *

# Load model, model config and tokenizer via Transformers
custom_config = AutoConfig.from_pretrained('allenai/scibert_scivocab_uncased')
custom_config.output_hidden_states=True
custom_tokenizer = AutoTokenizer.from_pretrained('allenai/scibert_scivocab_uncased')
custom_model = AutoModel.from_pretrained('allenai/scibert_scivocab_uncased', config=custom_config)

from summarizer import Summarizer

body = 'Text body that you want to summarize with BERT'
body2 = 'Something else you want to summarize with BERT'
model = Summarizer(custom_model=custom_model, custom_tokenizer=custom_tokenizer)
model(body)
model(body2)
```

### Large Example

```python
from summarizer import Summarizer

body = '''
The Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price.
The deal, first reported by The Real Deal, was for $150 million, according to a source familiar with the deal.
Mubadala, an Abu Dhabi investment fund, purchased 90% of the building for $800 million in 2008.
Real estate firm Tishman Speyer had owned the other 10%.
The buyer is RFR Holding, a New York real estate company.
Officials with Tishman and RFR did not immediately respond to a request for comments.
It's unclear when the deal will close.
The building sold fairly quickly after being publicly placed on the market only two months ago.
The sale was handled by CBRE Group.
The incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.
The rent is rising from $7.75 million last year to $32.5 million this year to $41 million in 2028.
Meantime, rents in the building itself are not rising nearly that fast.
While the building is an iconic landmark in the New York skyline, it is competing against newer office towers with large floor-to-ceiling windows and all the modern amenities.
Still the building is among the best known in the city, even to people who have never been to New York.
It is famous for its triangle-shaped, vaulted windows worked into the stylized crown, along with its distinctive eagle gargoyles near the top.
It has been featured prominently in many films, including Men in Black 3, Spider-Man, Armageddon, Two Weeks Notice and Independence Day.
The previous sale took place just before the 2008 financial meltdown led to a plunge in real estate prices.
Still there have been a number of high profile skyscrapers purchased for top dollar in recent years, including the Waldorf Astoria hotel, which Chinese firm Anbang Insurance purchased in 2016 for nearly $2 billion, and the Willis Tower in Chicago, which was formerly known as Sears Tower, once the world's tallest.
Blackstone Group (BX) bought it for $1.3 billion 2015.
The Chrysler Building was the headquarters of the American automaker until 1953, but it was named for and owned by Chrysler chief Walter Chrysler, not the company itself.
Walter Chrysler had set out to build the tallest building in the world, a competition at that time with another Manhattan skyscraper under construction at 40 Wall Street at the south end of Manhattan. He kept secret the plans for the spire that would grace the top of the building, building it inside the structure and out of view of the public until 40 Wall Street was complete.
Once the competitor could rise no higher, the spire of the Chrysler building was raised into view, giving it the title.
'''

model = Summarizer()
result = model(body, min_length=60)
full = ''.join(result)
print(full)
"""
The Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price. 
The building sold fairly quickly after being publicly placed on the market only two months ago.
The incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.'
Still the building is among the best known in the city, even to people who have never been to New York.
"""
```

### Calculating Elbow

As of bert-extractive-summarizer version 0.7.1, you can also calculate ELBOW to determine the optimal cluster. Below 
shows a sample example in how to retrieve the list of inertias.

```python
from summarizer import Summarizer

body = 'Your Text here.'
model = Summarizer()
res = model.calculate_elbow(body, k_max=10)
print(res)
```

You can also find the optimal number of sentences with elbow using the following algorithm.

```python
from summarizer import Summarizer

body = 'Your Text here.'
model = Summarizer()
res = model.calculate_optimal_k(body, k_max=10)
print(res)
```

## Summarizer Options

```
model = Summarizer(
    model: This gets used by the hugging face bert library to load the model, you can supply a custom trained model here
    custom_model: If you have a pre-trained model, you can add the model class here.
    custom_tokenizer:  If you have a custom tokenizer, you can add the tokenizer here.
    hidden: Needs to be negative, but allows you to pick which layer you want the embeddings to come from.
    reduce_option: It can be 'mean', 'median', or 'max'. This reduces the embedding layer for pooling.
    sentence_handler: The handler to process sentences. If want to use coreference, instantiate and pass CoreferenceHandler instance
)

model(
    body: str # The string body that you want to summarize
    ratio: float # The ratio of sentences that you want for the final summary
    min_length: int # Parameter to specify to remove sentences that are less than 40 characters
    max_length: int # Parameter to specify to remove sentences greater than the max length,
    num_sentences: Number of sentences to use. Overrides ratio if supplied.
)
```

## Running the Service

There is a provided flask service and corresponding Dockerfile. Running the service is simple, and can be done though 
the Makefile with the two commands:

```
make docker-service-build
make docker-service-run
```

This will use the Bert-base-uncased model, which has a small representation. The docker run also accepts a variety of 
arguments for custom and different models. This can be done through a command such as:

```
docker build -t summary-service -f Dockerfile.service ./
docker run --rm -it -p 5000:5000 summary-service:latest -model bert-large-uncased
```

Other arguments can also be passed to the server. Below includes the list of available arguments.

* -greediness: Float parameter that determines how greedy nueralcoref should be
* -reduce: Determines the reduction statistic of the encoding layer (mean, median, max).
* -hidden: Determines the hidden layer to use for embeddings (default is -2)
* -port: Determines the port to use.
* -host: Determines the host to use.

Once the service is running, you can make a summarization command at the `http://localhost:5000/summarize` endpoint. 
This endpoint accepts a text/plain input which represents the text that you want to summarize. Parameters can also be 
passed as request arguments. The accepted arguments are:

* ratio: Ratio of sentences to summarize to from the original body. (default to 0.2)
* min_length: The minimum length to accept as a sentence. (default to 25)
* max_length: The maximum length to accept as a sentence. (default to 500)

An example of a request is the following:

```
POST http://localhost:5000/summarize?ratio=0.1

Content-type: text/plain

Body:
The Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price.
The deal, first reported by The Real Deal, was for $150 million, according to a source familiar with the deal.
Mubadala, an Abu Dhabi investment fund, purchased 90% of the building for $800 million in 2008.
Real estate firm Tishman Speyer had owned the other 10%.
The buyer is RFR Holding, a New York real estate company.
Officials with Tishman and RFR did not immediately respond to a request for comments.
It's unclear when the deal will close.
The building sold fairly quickly after being publicly placed on the market only two months ago.
The sale was handled by CBRE Group.
The incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.
The rent is rising from $7.75 million last year to $32.5 million this year to $41 million in 2028.
Meantime, rents in the building itself are not rising nearly that fast.
While the building is an iconic landmark in the New York skyline, it is competing against newer office towers with large floor-to-ceiling windows and all the modern amenities.
Still the building is among the best known in the city, even to people who have never been to New York.
It is famous for its triangle-shaped, vaulted windows worked into the stylized crown, along with its distinctive eagle gargoyles near the top.
It has been featured prominently in many films, including Men in Black 3, Spider-Man, Armageddon, Two Weeks Notice and Independence Day.
The previous sale took place just before the 2008 financial meltdown led to a plunge in real estate prices.
Still there have been a number of high profile skyscrapers purchased for top dollar in recent years, including the Waldorf Astoria hotel, which Chinese firm Anbang Insurance purchased in 2016 for nearly $2 billion, and the Willis Tower in Chicago, which was formerly known as Sears Tower, once the world's tallest.
Blackstone Group (BX) bought it for $1.3 billion 2015.
The Chrysler Building was the headquarters of the American automaker until 1953, but it was named for and owned by Chrysler chief Walter Chrysler, not the company itself.
Walter Chrysler had set out to build the tallest building in the world, a competition at that time with another Manhattan skyscraper under construction at 40 Wall Street at the south end of Manhattan. He kept secret the plans for the spire that would grace the top of the building, building it inside the structure and out of view of the public until 40 Wall Street was complete.
Once the competitor could rise no higher, the spire of the Chrysler building was raised into view, giving it the title.

Response:

{
    "summary": "The Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price. The buyer is RFR Holding, a New York real estate company. The incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building."
}
```



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/dmmiller612/bert-extractive-summarizer",
    "name": "bert-extractive-summarizer",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "bert,pytorch,machine learning,deep learning,extractive summarization,summary",
    "author": "Derek Miller",
    "author_email": "dmmiller612@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/a8/b4/5d54ed9cc177f10383554aa81a0e4e53aa10405b899f7cae96c1e39b1e7f/bert-extractive-summarizer-0.10.1.tar.gz",
    "platform": "",
    "description": "# Bert Extractive Summarizer\n\n![Build Status](https://github.com/dmmiller612/bert-extractive-summarizer/actions/workflows/test.yml/badge.svg)\n[![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)](https://github.com/dmmiller612/bert-extractive-summarizer)\n<img src=\"https://img.shields.io/pypi/v/bert-extractive-summarizer.svg\" />\n\nThis repo is the generalization of the lecture-summarizer repo. This tool utilizes the HuggingFace Pytorch transformers library\nto run extractive summarizations. This works by first embedding the sentences, then running a clustering algorithm, finding \nthe sentences that are closest to the cluster's centroids. This library also uses coreference techniques, utilizing the \nhttps://github.com/huggingface/neuralcoref library to resolve words in summaries that need more context. The greedyness of \nthe neuralcoref library can be tweaked in the CoreferenceHandler class.\n\nAs of the most recent version of bert-extractive-summarizer, by default, CUDA is used if a gpu is available.\n\nPaper: https://arxiv.org/abs/1906.04165\n\n### Try the Online Demo:\n\n[Distill Bert Summarization Demo](https://smrzr.io)\n\n# Table of Contents\n1. [Install](#install)\n2. [Examples](#examples)\n   1. [Simple Example](#simple-example)\n   2. [SBert](#use-sbert)\n   3. [Retrieve Embeddings](#retrieve-embeddings)\n   4. [Use Coreference](#use-coreference)\n   5. [Custom Model Example](#custom-model-example)\n   6. [Large Example](#large-example)\n3. [Calculating Elbow](#calculating-elbow)\n4. [Running the Service](#running-the-service)\n\n## Install\n\n```bash\npip install bert-extractive-summarizer\n```\n\n## Examples\n\n### Simple Example\n```python\nfrom summarizer import Summarizer\n\nbody = 'Text body that you want to summarize with BERT'\nbody2 = 'Something else you want to summarize with BERT'\nmodel = Summarizer()\nmodel(body)\nmodel(body2)\n```\n\n#### Specifying number of sentences\n\nNumber of sentences can be supplied as a ratio or an integer. Examples are provided below.\n\n```python\nfrom summarizer import Summarizer\nbody = 'Text body that you want to summarize with BERT'\nmodel = Summarizer()\nresult = model(body, ratio=0.2)  # Specified with ratio\nresult = model(body, num_sentences=3)  # Will return 3 sentences \n```\n\n#### Using multiple hidden layers as the embedding output\n\nYou can also concat the summarizer embeddings for clustering. A simple example is below.\n\n```python\nfrom summarizer import Summarizer\nbody = 'Text body that you want to summarize with BERT'\nmodel = Summarizer('distilbert-base-uncased', hidden=[-1,-2], hidden_concat=True)\nresult = model(body, num_sentences=3)\n```\n\n### Use SBert\nOne can use Sentence Bert with bert-extractive-summarizer with the newest version. It is based off the paper here:\nhttps://arxiv.org/abs/1908.10084, and the library here: https://www.sbert.net/. To get started,\nfirst install SBERT:\n\n```\npip install -U sentence-transformers\n```\n\nThen a simple example is the following:\n\n```python\nfrom summarizer.sbert import SBertSummarizer\n\nbody = 'Text body that you want to summarize with BERT'\nmodel = SBertSummarizer('paraphrase-MiniLM-L6-v2')\nresult = model(body, num_sentences=3)\n```\n\nIt is worth noting that all the features that you can do with the main Summarizer class, you can also do with SBert.\n\n### Retrieve Embeddings\nYou can also retrieve the embeddings of the summarization. Examples are below:\n\n```python\nfrom summarizer import Summarizer\nbody = 'Text body that you want to summarize with BERT'\nmodel = Summarizer()\nresult = model.run_embeddings(body, ratio=0.2)  # Specified with ratio. \nresult = model.run_embeddings(body, num_sentences=3)  # Will return (3, N) embedding numpy matrix.\nresult = model.run_embeddings(body, num_sentences=3, aggregate='mean')  # Will return Mean aggregate over embeddings. \n```\n\n### Use Coreference\nFirst ensure you have installed neuralcoref and spacy. It is worth noting that neuralcoref does not work with spacy > 0.2.1.\n```bash\npip install spacy\npip install transformers # > 4.0.0\npip install neuralcoref\n\npython -m spacy download en_core_web_md\n```\n\nThen to to use coreference, run the following:\n\n```python\nfrom summarizer import Summarizer\nfrom summarizer.text_processors.coreference_handler import CoreferenceHandler\n\nhandler = CoreferenceHandler(greedyness=.4)\n# How coreference works:\n# >>>handler.process('''My sister has a dog. She loves him.''', min_length=2)\n# ['My sister has a dog.', 'My sister loves a dog.']\n\nbody = 'Text body that you want to summarize with BERT'\nbody2 = 'Something else you want to summarize with BERT'\nmodel = Summarizer(sentence_handler=handler)\nmodel(body)\nmodel(body2)\n```\n\n### Custom Model Example\n```python\nfrom transformers import *\n\n# Load model, model config and tokenizer via Transformers\ncustom_config = AutoConfig.from_pretrained('allenai/scibert_scivocab_uncased')\ncustom_config.output_hidden_states=True\ncustom_tokenizer = AutoTokenizer.from_pretrained('allenai/scibert_scivocab_uncased')\ncustom_model = AutoModel.from_pretrained('allenai/scibert_scivocab_uncased', config=custom_config)\n\nfrom summarizer import Summarizer\n\nbody = 'Text body that you want to summarize with BERT'\nbody2 = 'Something else you want to summarize with BERT'\nmodel = Summarizer(custom_model=custom_model, custom_tokenizer=custom_tokenizer)\nmodel(body)\nmodel(body2)\n```\n\n### Large Example\n\n```python\nfrom summarizer import Summarizer\n\nbody = '''\nThe Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price.\nThe deal, first reported by The Real Deal, was for $150 million, according to a source familiar with the deal.\nMubadala, an Abu Dhabi investment fund, purchased 90% of the building for $800 million in 2008.\nReal estate firm Tishman Speyer had owned the other 10%.\nThe buyer is RFR Holding, a New York real estate company.\nOfficials with Tishman and RFR did not immediately respond to a request for comments.\nIt's unclear when the deal will close.\nThe building sold fairly quickly after being publicly placed on the market only two months ago.\nThe sale was handled by CBRE Group.\nThe incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.\nThe rent is rising from $7.75 million last year to $32.5 million this year to $41 million in 2028.\nMeantime, rents in the building itself are not rising nearly that fast.\nWhile the building is an iconic landmark in the New York skyline, it is competing against newer office towers with large floor-to-ceiling windows and all the modern amenities.\nStill the building is among the best known in the city, even to people who have never been to New York.\nIt is famous for its triangle-shaped, vaulted windows worked into the stylized crown, along with its distinctive eagle gargoyles near the top.\nIt has been featured prominently in many films, including Men in Black 3, Spider-Man, Armageddon, Two Weeks Notice and Independence Day.\nThe previous sale took place just before the 2008 financial meltdown led to a plunge in real estate prices.\nStill there have been a number of high profile skyscrapers purchased for top dollar in recent years, including the Waldorf Astoria hotel, which Chinese firm Anbang Insurance purchased in 2016 for nearly $2 billion, and the Willis Tower in Chicago, which was formerly known as Sears Tower, once the world's tallest.\nBlackstone Group (BX) bought it for $1.3 billion 2015.\nThe Chrysler Building was the headquarters of the American automaker until 1953, but it was named for and owned by Chrysler chief Walter Chrysler, not the company itself.\nWalter Chrysler had set out to build the tallest building in the world, a competition at that time with another Manhattan skyscraper under construction at 40 Wall Street at the south end of Manhattan. He kept secret the plans for the spire that would grace the top of the building, building it inside the structure and out of view of the public until 40 Wall Street was complete.\nOnce the competitor could rise no higher, the spire of the Chrysler building was raised into view, giving it the title.\n'''\n\nmodel = Summarizer()\nresult = model(body, min_length=60)\nfull = ''.join(result)\nprint(full)\n\"\"\"\nThe Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price. \nThe building sold fairly quickly after being publicly placed on the market only two months ago.\nThe incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.'\nStill the building is among the best known in the city, even to people who have never been to New York.\n\"\"\"\n```\n\n### Calculating Elbow\n\nAs of bert-extractive-summarizer version 0.7.1, you can also calculate ELBOW to determine the optimal cluster. Below \nshows a sample example in how to retrieve the list of inertias.\n\n```python\nfrom summarizer import Summarizer\n\nbody = 'Your Text here.'\nmodel = Summarizer()\nres = model.calculate_elbow(body, k_max=10)\nprint(res)\n```\n\nYou can also find the optimal number of sentences with elbow using the following algorithm.\n\n```python\nfrom summarizer import Summarizer\n\nbody = 'Your Text here.'\nmodel = Summarizer()\nres = model.calculate_optimal_k(body, k_max=10)\nprint(res)\n```\n\n## Summarizer Options\n\n```\nmodel = Summarizer(\n    model: This gets used by the hugging face bert library to load the model, you can supply a custom trained model here\n    custom_model: If you have a pre-trained model, you can add the model class here.\n    custom_tokenizer:  If you have a custom tokenizer, you can add the tokenizer here.\n    hidden: Needs to be negative, but allows you to pick which layer you want the embeddings to come from.\n    reduce_option: It can be 'mean', 'median', or 'max'. This reduces the embedding layer for pooling.\n    sentence_handler: The handler to process sentences. If want to use coreference, instantiate and pass CoreferenceHandler instance\n)\n\nmodel(\n    body: str # The string body that you want to summarize\n    ratio: float # The ratio of sentences that you want for the final summary\n    min_length: int # Parameter to specify to remove sentences that are less than 40 characters\n    max_length: int # Parameter to specify to remove sentences greater than the max length,\n    num_sentences: Number of sentences to use. Overrides ratio if supplied.\n)\n```\n\n## Running the Service\n\nThere is a provided flask service and corresponding Dockerfile. Running the service is simple, and can be done though \nthe Makefile with the two commands:\n\n```\nmake docker-service-build\nmake docker-service-run\n```\n\nThis will use the Bert-base-uncased model, which has a small representation. The docker run also accepts a variety of \narguments for custom and different models. This can be done through a command such as:\n\n```\ndocker build -t summary-service -f Dockerfile.service ./\ndocker run --rm -it -p 5000:5000 summary-service:latest -model bert-large-uncased\n```\n\nOther arguments can also be passed to the server. Below includes the list of available arguments.\n\n* -greediness: Float parameter that determines how greedy nueralcoref should be\n* -reduce: Determines the reduction statistic of the encoding layer (mean, median, max).\n* -hidden: Determines the hidden layer to use for embeddings (default is -2)\n* -port: Determines the port to use.\n* -host: Determines the host to use.\n\nOnce the service is running, you can make a summarization command at the `http://localhost:5000/summarize` endpoint. \nThis endpoint accepts a text/plain input which represents the text that you want to summarize. Parameters can also be \npassed as request arguments. The accepted arguments are:\n\n* ratio: Ratio of sentences to summarize to from the original body. (default to 0.2)\n* min_length: The minimum length to accept as a sentence. (default to 25)\n* max_length: The maximum length to accept as a sentence. (default to 500)\n\nAn example of a request is the following:\n\n```\nPOST http://localhost:5000/summarize?ratio=0.1\n\nContent-type: text/plain\n\nBody:\nThe Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price.\nThe deal, first reported by The Real Deal, was for $150 million, according to a source familiar with the deal.\nMubadala, an Abu Dhabi investment fund, purchased 90% of the building for $800 million in 2008.\nReal estate firm Tishman Speyer had owned the other 10%.\nThe buyer is RFR Holding, a New York real estate company.\nOfficials with Tishman and RFR did not immediately respond to a request for comments.\nIt's unclear when the deal will close.\nThe building sold fairly quickly after being publicly placed on the market only two months ago.\nThe sale was handled by CBRE Group.\nThe incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.\nThe rent is rising from $7.75 million last year to $32.5 million this year to $41 million in 2028.\nMeantime, rents in the building itself are not rising nearly that fast.\nWhile the building is an iconic landmark in the New York skyline, it is competing against newer office towers with large floor-to-ceiling windows and all the modern amenities.\nStill the building is among the best known in the city, even to people who have never been to New York.\nIt is famous for its triangle-shaped, vaulted windows worked into the stylized crown, along with its distinctive eagle gargoyles near the top.\nIt has been featured prominently in many films, including Men in Black 3, Spider-Man, Armageddon, Two Weeks Notice and Independence Day.\nThe previous sale took place just before the 2008 financial meltdown led to a plunge in real estate prices.\nStill there have been a number of high profile skyscrapers purchased for top dollar in recent years, including the Waldorf Astoria hotel, which Chinese firm Anbang Insurance purchased in 2016 for nearly $2 billion, and the Willis Tower in Chicago, which was formerly known as Sears Tower, once the world's tallest.\nBlackstone Group (BX) bought it for $1.3 billion 2015.\nThe Chrysler Building was the headquarters of the American automaker until 1953, but it was named for and owned by Chrysler chief Walter Chrysler, not the company itself.\nWalter Chrysler had set out to build the tallest building in the world, a competition at that time with another Manhattan skyscraper under construction at 40 Wall Street at the south end of Manhattan. He kept secret the plans for the spire that would grace the top of the building, building it inside the structure and out of view of the public until 40 Wall Street was complete.\nOnce the competitor could rise no higher, the spire of the Chrysler building was raised into view, giving it the title.\n\nResponse:\n\n{\n    \"summary\": \"The Chrysler Building, the famous art deco New York skyscraper, will be sold for a small fraction of its previous sales price. The buyer is RFR Holding, a New York real estate company. The incentive to sell the building at such a huge loss was due to the soaring rent the owners pay to Cooper Union, a New York college, for the land under the building.\"\n}\n```\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Extractive Text Summarization with BERT",
    "version": "0.10.1",
    "project_urls": {
        "Download": "https://github.com/dmmiller612/bert-extractive-summarizer/archive/0.10.1.tar.gz",
        "Homepage": "https://github.com/dmmiller612/bert-extractive-summarizer"
    },
    "split_keywords": [
        "bert",
        "pytorch",
        "machine learning",
        "deep learning",
        "extractive summarization",
        "summary"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "050c15e2231a72f4ff61e297a03d4e037b2798720f428e835deb43675e7e5926",
                "md5": "ac340d0393d747beaffe5aaf7a365615",
                "sha256": "46897531f76a18943542e2bec58d728625bb70e09995891f717e005bd1b26b87"
            },
            "downloads": -1,
            "filename": "bert_extractive_summarizer-0.10.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ac340d0393d747beaffe5aaf7a365615",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 25192,
            "upload_time": "2022-01-04T00:30:11",
            "upload_time_iso_8601": "2022-01-04T00:30:11.766766Z",
            "url": "https://files.pythonhosted.org/packages/05/0c/15e2231a72f4ff61e297a03d4e037b2798720f428e835deb43675e7e5926/bert_extractive_summarizer-0.10.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a8b45d54ed9cc177f10383554aa81a0e4e53aa10405b899f7cae96c1e39b1e7f",
                "md5": "b3a8ad4b13faf373e96ea4c7b0d4080c",
                "sha256": "b316e0540b71df2c2120de2d5ccb97cdbd621b30fb0f4c4d93343a22b9365f3d"
            },
            "downloads": -1,
            "filename": "bert-extractive-summarizer-0.10.1.tar.gz",
            "has_sig": false,
            "md5_digest": "b3a8ad4b13faf373e96ea4c7b0d4080c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 17261,
            "upload_time": "2022-01-04T00:30:13",
            "upload_time_iso_8601": "2022-01-04T00:30:13.278222Z",
            "url": "https://files.pythonhosted.org/packages/a8/b4/5d54ed9cc177f10383554aa81a0e4e53aa10405b899f7cae96c1e39b1e7f/bert-extractive-summarizer-0.10.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-01-04 00:30:13",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "dmmiller612",
    "github_project": "bert-extractive-summarizer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "bert-extractive-summarizer"
}
        
Elapsed time: 0.17253s