Client Installation and Setup
To use the CoreNLP client, please first make sure that you have correctly installed the Stanza library. Follow these instructions to install the library.
After the library is installed, you’ll need to install the CoreNLP software package and make sure Stanza knows where the downloaded package is located on your computer. There are two ways to do this.
New in v1.1
The automated installation function is the simplest way to install CoreNLP along with the default models:
import stanza stanza.install_corenlp(dir="YOUR_CORENLP_FOLDER")
The first argument
dir sets where you want your CoreNLP to be installed; or if
dir is not set, by default it is installed in the path specified by the
$CORENLP_HOME environment variable, or in the
~/stanza_corenlp folder if
$CORENLP_HOME isn’t set either. If you choose to set
dir to your own customized directory, you’ll also need to point the environment variable
$CORENLP_HOME to this location after installing CoreNLP. On Linux/Unix or macOS, this can be done with running
Apart from the default package distribution, CoreNLP also provides additional models for six different languages. To install these additional models, you can do:
stanza.download_corenlp_models(model='french', version='4.1.0', dir="YOUR_CORENLP_FOLDER")
model argument specifies the model package that you want to install, and can be set to one of
'arabic', 'chinese', 'english', 'english-kbp', 'french', 'german', 'spanish'; the
version argument specifies the model version, for which
4.1.0 is the latest; and
dir needs to point to your customized CoreNLP installation location, or the models will be installed to the default location.
You can manually install CoreNLP if the automated method fails. You need to:
- Download the latest version of Stanford CoreNLP from here and follow the instructions to setup the environment.
- Download model files for the language you want to annotate from here and store them in the extracted CoreNLP folder. You can skip this step if you only want to use the default English models shipped with the CoreNLP software.
- Set the
CORENLP_HOMEenvironment variable to the location of the CoreNLP root folder. Example:
export CORENLP_HOME=/path/to/stanford-corenlp-4.1.0. Stanza will use this environment variable to locate the CoreNLP package at runtime.