Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/proycon/alpino_clam_webservice

A CLAM-powered webservice for Alpino, a dependency parser for Dutch
https://github.com/proycon/alpino_clam_webservice

Last synced: 24 days ago
JSON representation

A CLAM-powered webservice for Alpino, a dependency parser for Dutch

Awesome Lists containing this project

README

        

[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

# Alpino webservice

*(Licensed under the GNU Public License v3)*

This is a webservice for [Alpino](http://www.let.rug.nl/vannoord/alp/Alpino/),
a dependency parser for Dutch developed at the University of Groningen. The
webservice is powered by [CLAM](https://proycon.github.io/clam). It offers a RESTful API as well as a web-interface for human end-users.

This webservice has support for [FoLiA](https://github.com/proycon/folia) input/output.

## Installation

### Development

Clone this repository, create a virtual environment and install the webservice as follows:

```
$ python3 -m venv env
$ . env/bin/activate
$ ./startserver_development.sh
```

Navigate to ``http://localhost:8080``.

Note that for this to work, Alpino must already be installed on your system (and in your `$PATH` with `$ALPINO_HOME`
also set).

### Production

A ``Dockerfile`` is provided for deployment in production environments.

From the repository root, build as follows:

``
$ docker build -t proycon/alpino_webservice .
``

Consult the [Dockerfile](Dockerfile) for various build-time parameters that you may want to set for your own production environment.

When running, mount the path where you want the user data stored into the container, a directory `alpino` will be created here:

``
$ docker run -p 8080:80 -v /path/to/data/dir:/data proycon/alpino_webservice
``