Skip to main content

Fast, robust sentence splitting with bindings for Python, Rust and Javascript.

Project description

NNSplit Python Bindings

PyPI CI License

Fast, robust sentence splitting with bindings for Python, Rust and Javascript and pretrained models for English and German.


NNSplit has PyTorch as the only dependency.

Install it with pip: pip install nnsplit


>>> from nnsplit import NNSplit
>>> splitter = NNSplit("en")
# NNSplit does not depend on proper punctuation and casing to split sentences
>>> splitter.split(["This is a test This is another test."])
[[[Token(text='This', whitespace=' '),
   Token(text='is', whitespace=' '),
   Token(text='a', whitespace=' '),
   Token(text='test', whitespace=' ')],
  [Token(text='This', whitespace=' '),
   Token(text='is', whitespace=' '),
   Token(text='another', whitespace=' '),
   Token(text='test', whitespace=''),
   Token(text='.', whitespace='')]]]

Models for German (NNSplit("de")) and English (NNSplit("en")) come prepackaged with NNSplit. Alternatively, you can also load your own model:

import torch
model = torch.jit.load("/path/to/your/") # a regular nn.Module works too

splitter = NNSplit(model)

See train.ipynb for the code used to train the pretrained models.


NNSplit uses Poetry for dependency management. I made a small Makefile to automate some steps. Take a look at the Makefile and run make install, make build, make test to install, build and test the library, respectively.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nnsplit, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size nnsplit-0.2.1-py3-none-any.whl (2.3 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size nnsplit-0.2.1.tar.gz (2.3 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page