1
0
Fork 0
Você não pode selecionar mais de 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
 
 
 
 
 
 
Ir para arquivo
J. Fernando Sánchez c4321dc500 Update schema examples 5 anos atrás
.makefiles Multiple changes in the API, schemas and UI 5 anos atrás
docs Update schema examples 5 anos atrás
example-plugins Multiple changes in the API, schemas and UI 5 anos atrás
img Started readthedocs and improved README 9 anos atrás
k8s Multiple changes in the API, schemas and UI 5 anos atrás
senpy restore hash function in js 5 anos atrás
tests Release 0.20 5 anos atrás
.drone.yml Improved plugins API and loading 8 anos atrás
.gitignore Deployment changes 7 anos atrás
.gitlab-ci.yml Update docs + notebooks 5 anos atrás
.pre-commit-config.yaml Fixed CI problem 7 anos atrás
.travis.yml Small tweaks in docs 5 anos atrás
CHANGELOG.md restore hash function in js 5 anos atrás
Dockerfile.template Fix schema issues and parameter validation 6 anos atrás
LICENSE.txt Refactoring, name change 10 anos atrás
MANIFEST.in Add license to manifest 5 anos atrás
Makefile Multiple changes in the API, schemas and UI 5 anos atrás
NOTICE Refactoring, name change 10 anos atrás
Procfile Multiple changes in the API, schemas and UI 5 anos atrás
README.rst Multiple changes in the API, schemas and UI 5 anos atrás
dev-requirements.txt PEP8 compliance 9 anos atrás
docker-compose.dev.yml Allow activation fails 6 anos atrás
docker-compose.test.yml Allow activation fails 6 anos atrás
docker-compose.yml Allow activation fails 6 anos atrás
extra-requirements.txt Multiple changes in the API, schemas and UI 5 anos atrás
requirements.txt Multiple changes in the API, schemas and UI 5 anos atrás
setup.cfg Multiple changes in the API, schemas and UI 5 anos atrás
setup.py Multiple changes in the API, schemas and UI 5 anos atrás
supervisord.conf Files for deployment 10 anos atrás
test-requirements.txt Multiple changes in the API, schemas and UI 5 anos atrás

README.rst

.. image:: img/header.png
   :width: 100%
   :target: http://senpy.gsi.upm.es

.. image:: https://travis-ci.org/gsi-upm/senpy.svg?branch=master
   :target: https://travis-ci.org/gsi-upm/senpy

.. image:: https://lab.gsi.upm.es/senpy/senpy/badges/master/pipeline.svg
   :target: https://lab.gsi.upm.es/senpy/senpy/commits/master

.. image:: https://lab.gsi.upm.es/senpy/senpy/badges/master/coverage.svg
   :target: https://lab.gsi.upm.es/senpy/senpy/commits/master

.. image:: https://img.shields.io/pypi/l/requests.svg
   :target: https://lab.gsi.upm.es/senpy/senpy/

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 <http://persistence.uni-leipzig.org/nlp2rdf/>`_, `Marl <http://www.gsi.dit.upm.es/ontologies/marl>`_, `Onyx <http://www.gsi.dit.upm.es/ontologies/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. <http://senpy.gsi.upm.es/>`_

Installation
------------
The stable version can be installed in three ways.

Through PIP
***********

.. code:: bash

   pip install -U --user senpy

   
Alternatively, you can use the development version:
 
.. code:: bash

   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``


Developing
----------

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

.. code:: bash


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

Building a docker image
***********************

.. code:: bash


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

Testing
*******

.. code:: bash


    make test

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

.. code:: bash


    # 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.

.. code:: bash


   senpy

or, alternatively:

.. code:: bash


    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.


`DEMO on heroku <http://senpy.herokuapp.com>`_


For more information, check out the `documentation <http://senpy.readthedocs.org>`_.
------------------------------------------------------------------------------------


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.


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.


.. image:: img/me.png
    :target: http://mixedemotions-project.eu
    :height: 100px
    :alt: MixedEmotions Logo

.. image:: img/eu-flag.jpg
    :height: 100px
    :target: http://ec.europa.eu/research/participants/portal/desktop/en/opportunities/index.html