spaCy/website/usage/_models/_install-basics.jade

//- 💫 DOCS > USAGE > MODELS > INSTALLATION BASICS

p
    |  The easiest way to download a model is via spaCy's
    |  #[+api("cli#download") #[code download]] command. It takes care of
    |  finding the best-matching model compatible with your spaCy installation.

- var models = Object.keys(MODELS).map(function(lang) { return "python -m spacy download " + lang })
+code(false, "bash").
    # out-of-the-box: download best-matching default model
    #{Object.keys(MODELS).map(function(l) {return "python -m spacy download " + l}).join('\n')}

    # download best-matching version of specific model for your spaCy installation
    python -m spacy download en_core_web_sm

    # download exact model version (doesn't create shortcut link)
    python -m spacy download en_core_web_sm-2.0.0 --direct

p
    |  The download command will #[+a("/usage/models#download-pip") install the model] via
    |  pip, place the package in your #[code site-packages] directory and create
    |  a #[+a("/usage/models#usage") shortcut link] that lets you load the model by a custom
    |  name. The shortcut link will be the same as the model name used in
    |  #[code spacy download].

+code(false, "bash").
    pip install spacy
    python -m spacy download en

+code.
    import spacy
    nlp = spacy.load('en')
    doc = nlp(u'This is a sentence.')

+infobox("Important note", "⚠️")
    |  To allow loading models via convenient shortcuts like #[code 'en'], spaCy
    |  will create a symlink within the #[code spacy/data] directory. This means
    |  that your user needs the #[strong required permissions].
    |  If you've installed spaCy to a system directory and don't have admin
    |  privileges, the model linking may fail. The easiest solution
    |  is to re-run the command as admin, or use a #[code virtualenv]. For more
    |  info on this, see the
    |  #[+a("/usage/#symlink-privilege") troubleshooting guide].