Skip to main content

A sentiment analysis server implementation. Designed to be extensible, so new algorithms and sources can be used.

Project description

img/header.png https://readthedocs.org/projects/senpy/badge/?version=latest https://badge.fury.io/py/senpy.svg https://travis-ci.org/gsi-upm/senpy.svg https://img.shields.io/pypi/l/requests.svg

Senpy lets you create sentiment analysis web services easily, fast and using a well known API. As a bonus, Senpy services use semantic vocabularies (e.g. NIF, Marl, Onyx) and formats (turtle, JSON-LD, xml-rdf).

Have you ever wanted to turn your sentiment analysis algorithms into a service? With Senpy, now you can. It provides all the tools so you just have to worry about improving your algorithms:

See it in action.

Installation

The stable version can be installed in three ways.

Through PIP

pip install -U --user senpy

Alternatively, you can use the development version:

git clone http://github.com/gsi-upm/senpy
cd senpy
pip install --user .

If you want to install Senpy globally, use sudo instead of the --user flag.

Docker Image

Build the image or use the pre-built one: docker run -ti -p 5000:5000 gsiupm/senpy.

To add custom plugins, add a volume and tell Senpy where to find the plugins: docker run -ti -p 5000:5000 -v <PATH OF PLUGINS>:/plugins gsiupm/senpy -f /plugins

Compatibility

Senpy should run on any major operating system. Its code is pure Python, and the only limitations are imposed by its dependencies (e.g., nltk, pandas).

Currently, the CI/CD pipeline tests the code on:

  • GNU/Linux with Python versions 3.7+ (3.10+ recommended for all plugins)

  • MacOS and homebrew’s python3

  • Windows 10 and chocolatey’s python3

The latest PyPI package is verified to install on Ubuntu, Debian and Arch Linux.

If you have trouble installing Senpy on your platform, see Having problems?.

Developing

Running/debugging

This command will run the senpy container using the latest image available, mounting your current folder so you get your latest code:

# Python 3.5
make dev
# Python 2.7
make dev-2.7

Building a docker image

# Python 3.5
make build-3.5
# Python 2.7
make build-2.7

Testing

make test

Running

This command will run the senpy server listening on localhost:5000

# Python 3.5
make run-3.5
# Python 2.7
make run-2.7

Usage

However, the easiest and recommended way is to just use the command-line tool to load your plugins and launch the server.

senpy

or, alternatively:

python -m senpy

This will create a server with any modules found in the current path. For more options, see the –help page.

Alternatively, you can use the modules included in Senpy to build your own application.

Deploying on Heroku

Use a free heroku instance to share your service with the world. Just use the example Procfile in this repository, or build your own.

For more information, check out the documentation.

Python 2.x compatibility

Keeping compatibility between python 2.7 and 3.x is not always easy, especially for a framework that deals both with text and web requests. Hence, starting February 2019, this project will no longer make efforts to support python 2.7, which will reach its end of life in 2020. Most of the functionality should still work, and the compatibility shims will remain for now, but we cannot make any guarantees at this point. Instead, the maintainers will focus their efforts on keeping the codebase compatible across different Python 3.3+ versions, including upcoming ones. We apologize for the inconvenience.

Having problems?

Please, file a new issue on GitHub including enough details to reproduce the bug, including:

  • Operating system

  • Version of Senpy (or docker tag)

  • Installed libraries

  • Relevant logs

  • A simple code example

Acknowledgement

This development has been partially funded by the European Union through the MixedEmotions Project (project number H2020 655632), as part of the RIA ICT 15 Big data and Open Data Innovation and take-up programme.

MixedEmotions Logo img/eu-flag.jpg

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

senpy-1.0.7.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

senpy-1.0.7-py2.py3-none-any.whl (1.2 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file senpy-1.0.7.tar.gz.

File metadata

  • Download URL: senpy-1.0.7.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.13

File hashes

Hashes for senpy-1.0.7.tar.gz
Algorithm Hash digest
SHA256 a8283e5e0b36f583b33180a55cd1b54b34059353959a15cc999f1903e1eef8d2
MD5 0a6345447f89ca4875f09f7b189fc8f6
BLAKE2b-256 00d146cfed829244b8a26716b0687e23e050e9204b7e42d3686e1660c7cfd589

See more details on using hashes here.

File details

Details for the file senpy-1.0.7-py2.py3-none-any.whl.

File metadata

  • Download URL: senpy-1.0.7-py2.py3-none-any.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.13

File hashes

Hashes for senpy-1.0.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 d48ef1aee769a9418512ebb2be843a12be164ad195b0ebf319476e9eb8837126
MD5 233ce8ac0470ee814fd3fcdbb200b6ff
BLAKE2b-256 2bfe082ffba5f63a13908ff6826bada59117a390506beae0444573a0f6bee6d3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page