An HTTP REST server frontend for Stanford Core NLP written in Clojure using the Luminus framework.
From source directory:
docker build -t corenlpd .
docker run -d --name corenlpd -p 5900:5900 corenlpd
From source directory:
docker-compose up -d
You can install this on a normal machine or run it on AWS Elastic Beanstalk (see below).
You will need Leiningen 2.0 or above installed.
To install as an Upstart service, copy source to /usr/local/bin/corenlpd (or change path in corenlpd.conf) and run:
lein uberjar
Add a user for the service (as root):
sudo adduser --disabled-password --gecos "" corenlpd
Add corenlpd to sudoers.d (as root):
sudo sh -c "echo \"corenlpd ALL=NOPASSWD: /usr/local/bin/corenlpd/target/corenlpd.jar\" >> /etc/sudoers.d/corenlpd"
sudo chmod 0440 /etc/sudoers.d/corenlpd
OR add corenlpd to suders directly (as root):
sudo sh -c "echo \"corenlpd ALL=NOPASSWD: /usr/local/bin/corenlpd/target/corenlpd.jar\" >> /etc/sudoers"
(Or remove the setuid and setgid entries in corenlpd.conf and run as the invoking user at your own risk.)
Then copy corenlpd.conf to /etc/init to install the Upstart job and run:
service corenlpd start
To deploy on AWS Elastic Beanstalk with Docker:
eb init
Select Docker as the application type and create a new environment:
eb create --vpc corenlpd-docker-prod
Use --vpc to create a Beanstalk app with an internal load balancer that'd not exposed to the Internet.
eb use corenlpd-docker prod
eb deploy
See the documentation for environment variables and the command line needed to set them. These only need to be set once.
You'll need to create a Tomcat 8 / Java 8 AWS environment (otherwise it'll default to Java 7 and fail). After than, when you have the repo, switch to the master branch and:
eb init
Choose us-east-1 for the region and corenlpd for the app (change as needed). The init, create, and use steps only have to be done once.
eb create corenlpd-prod
eb use corenlpd-prod
Please make sure you're in the master branch when deploying to avoid deploying the wrong branch! After the first deploy, from the master branch just do:
lein beanstalk deploy corenlpd-prod
Note that lein must be used for deployment in this case. eb deploy does not properly set things up to run this Clojure app as it assumes a Java app.
To run as a server:
Or:
lein run
By default, the server runs on port 5900 for testing. In production, set the PORT environment variable.
lein test
It takes one argument, text and returns the parsed XML:
GET /parse?text=This+is+a+sentence.
It takes one argument, text and returns the parsed XML. The argument must have POS tags seperated by a slash:
GET /parse-with-pos?text=Document/VB+software/NN+./.
MIT (See LICENSE)
Copyright © 2016 Lucian Hontau