These docs are for version 1.x of Rasa Open Source.

• Docs for the new version 2.0 can be found here.

Installation

Quick Installation

You can install Rasa Open Source using pip (requires Python 3.6 or 3.7).

$ pip3 install rasa

• Having trouble installing? Read our step-by-step installation guide.

• You can also build Rasa Open Source from source.

• For advanced installation options such as building from source and installation instructions for custom pipelines, head over here.

Congratulations! You have successfully installed Rasa Open Source!

Step-by-step Installation Guide

1. Install the Python development environment

Check if your Python environment is already configured:

$ python3 --version
$ pip3 --version

If these packages are already installed, these commands should display version numbers for each step, and you can skip to the next step.

2. Create a virtual environment (strongly recommended)

Tools like virtualenv and virtualenvwrapper provide isolated Python environments, which are cleaner than installing packages systemwide (as they prevent dependency conflicts). They also let you install packages without root privileges.

3. Install Rasa Open Source

You can now head over to the tutorial.

Building from Source

If you want to use the development version of Rasa Open Source, you can get it from GitHub:

$ curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
$ git clone https://github.com/RasaHQ/rasa.git
$ cd rasa
$ poetry install

NLU Pipeline Dependencies

How do I choose a pipeline?

The page on Choosing a Pipeline will help you pick the right pipeline for your assistant.

I have decided on a pipeline. How do I install the dependencies for it?

When you install Rasa Open Source, the dependencies for the supervised_embeddings - TensorFlow and sklearn_crfsuite get automatically installed. However, spaCy and MITIE need to be separately installed if you want to use pipelines containing components from those libraries.

Just give me everything!

You’ll first need to clone the repository and then run the following command to install all the packages:

$ poetry install --extras full

Dependencies for spaCy

You can install it with the following commands:

$ pip install rasa[spacy]
$ python -m spacy download en_core_web_md
$ python -m spacy link en_core_web_md en

This will install Rasa Open Source as well as spaCy and its language model for the English language.

Dependencies for MITIE

First, run

$ pip install git+https://github.com/mit-nlp/MITIE.git
$ pip install rasa[mitie]

and then download the MITIE models.

Warning

Mitie support is likely to be deprecated in a future release.