Quick Installation

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

$ pip3 install rasa

When you’re done installing, you can head over to the tutorial!

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.

Otherwise, proceed with the instructions below to install them.

Fetch the relevant packages using apt, and install virtualenv using pip.

$ sudo apt update
$ sudo apt install python3-dev python3-pip

Install the Homebrew package manager if you haven’t already.

Once you’re done, you can install Python3.

$ brew update
$ brew install python
Make sure the Microsoft VC++ Compiler is installed, so python can compile any dependencies. You can get the compiler from Visual Studio. Download the installer and select VC++ Build tools in the list.

Install Python 3 (64-bit version) for Windows.

C:\> pip3 install -U pip


Note that pip in this refers to pip3 as Rasa Open Source requires python3. To see which version the pip command on your machine calls use pip –version.

3. Install Rasa Open Source

First make sure your pip version is up to date:

$ pip install -U pip

To install Rasa Open Source:

$ pip install rasa

Congratulations! You have successfully installed 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 | python
$ git clone
$ cd rasa
$ poetry install

NLU Pipeline Dependencies

Several NLU components have additional dependencies that need to be installed separately.

Here, you will find installation instructions for each of them below.

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!

If you don’t mind the additional dependencies lying around, you can use this to install 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

For more information on spaCy, check out the spaCy docs.

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. We recommend using at least the “medium” sized models (_md) instead of the spaCy’s default small en_core_web_sm model. Small models require less memory to run, but will somewhat reduce intent classification performance.

Dependencies for MITIE

First, run

$ pip install git+
$ pip install rasa[mitie]

and then download the MITIE models. The file you need is total_word_feature_extractor.dat. Save this anywhere. If you want to use MITIE, you need to tell it where to find this file (in this example it was saved in the data folder of the project directory).


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