Stanford CoreNLP XML Server

About

This software offers the sutime functionality of the Stanford CoreNLP as HTTP-XML-Server. This avoids the time-consuming initialization every time CoreNLP is started. It is very similar to their demo interface seen at http://nlp.stanford.edu:8080/sutime/process.

This version has the two sutime properties sutime.markRanges and sutime.includeRange hardcoded set to true.

Example

The server will be listening at http://localhost:8080. The text you want to analyze needs to be POSTed as field text and field date for the default date for sutime parsing (yyyy-mm-dd):

 curl --data 'text=we will meet next week&date=2014-09-10' http://localhost:8080

Installation

1. Clone the repository:

    git clone https://github.com/quasarchimaere/StanfordCoreNLPXMLServer.git
   

2. Download and install the third party libraries:

    cd StanfordCoreNLPXMLServer
    ant libs
   

3. Compile the JAR file:

    ant jar
   

4. Run the server:

    ant run
   

5. The server is now waiting on http://localhost:8080 for HTTP POST requests. Note the initialization can take a few minutes, because several modules and resources of Stanford CoreNLP need to be loaded.

   You can also choose a port:

    ant run -Dport=9000
   

Prerequisites

• Oracle JDK or OpenJDK version 6 or later
• Apache Ant

Third Party Libraries

The Stanford CoreNLP XML Server uses the following third party libraries:

• Stanford CoreNLP, a suite of core NLP tools
• Simple, a Java based HTTP engine

The libraries can be downloaded and set up using the ant target libs (see Installation).

License

• Stanford CoreNLP is licensed under the GNU General Public License (v2 or later).
• Simple is licensed under the Apache License, Version 2.0

Due to compatibility issues (see GNU.org and Apache.org), the Stanford CoreNLP XML Server is licensed under the GNU General Public License Version 3.