Metadata-Version: 2.1
Name: esntorch
Version: 1.0.6
Summary: Python library: Echo state Networks for NLP
Home-page: 
Author: Playtika Ltd.
Author-email: 
License: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: datasets (==1.7.0)
Requires-Dist: ipywidgets (==7.7.1)
Requires-Dist: numpy (==1.22.3)
Requires-Dist: pytest (==6.2.4)
Requires-Dist: scikit-learn (==1.1.2)
Requires-Dist: setuptools (==63.4.2)
Requires-Dist: torch (==1.7.1)
Requires-Dist: tqdm (==4.49.0)
Requires-Dist: transformers (==4.8.2)

# EsnTorch (version 1.0.6)
**Echo state networks (ESNs) for natural language processing (NLP).**

``EsnTorch`` is a user-friendly python library designed for the implementation of **echo state networks (ESNs)**
in the context of **natural language processing (NLP)**, and more specifically, 
in the context of **text classification**.

``EsnTorch`` is written in ``PyTorch`` and requires Python 3.7 or higher.


Installation
------------

This library is distributed on [PyPi](https://pypi.org/project/esntorch/) and
can be installed with ``pip``, as shown below:

~~~~~~~~~~~~~~~~~~~~~~
$ pip install esntorch 
~~~~~~~~~~~~~~~~~~~~~~

This command will automatically install the dependencies listed in ``requirements.txt`` 
together with the library itself.

Please visit the [installation page](docs/src/installation.rst) for more details.


GitHub
------

The source code of the library is available on [GitHub](https://github.com/PlaytikaResearch/EsnTorch). 
It can be cloned with the following command:
 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ git clone https://github.com/PlaytikaResearch/EsnTorch.git
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Once cloned, you can install the library by running one of the following commands 
from the root directory ``esntorch/``:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ pip install .                        # install library + dependencies
$ pip install -r requirements.txt      # install dependencies
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Documentation
-------------

The [documentation page](https://playtikaresearch.github.io/esntorch/index.html) 
provides a detailed documentation of the library as well as tutorials covering 
its main functionalities.


More Info
---------

To create the HTML documentation run the following commands:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ cd docs
$ sphinx-apidoc -o source/ ../esntorch
$ make clean
$ make html
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To make the library pip instalable, create and `.whl` file and deploy it on [PyPi](https://pypi.org/project/esntorch/). 
Make sure that `twine` is installed and run the following commands:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
$ python setup.py bdist_wheel
$ twine upload -r pypi dist/*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


License
-------

[MIT License.](LICENSE)
