Version: 3.x

Installing Rasa Open Source

Want to explore first?

You can explore Rasa Open Source online using the Rasa Playground even before you install. At the end of the tutorial you can download the resulting assistant, install Rasa on your machine and continue development locally.

Rasa Playground

Install Rasa Open Source

First make sure your pip version is up to date:

pip3 install -U pip

To install Rasa Open Source:

pip3 install rasa
Telemetry reporting

When you run Rasa Open Source for the first time, you’ll see a message notifying you about anonymous usage data that is being collected. You can read more about how that data is pulled out and what it is used for in the telemetry documentation.

Congratulations! You have successfully installed Rasa Open Source!

You can now create a new project with:

rasa init

You can learn about the most important Rasa commands in the Command Line Interface.

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

Due to lack of official TensorFlow support for the Apple M1, Rasa Open Source is currently unable to train a model using M1.

Additional dependencies

For some machine learning algorithms you need to install additional python packages. They aren't installed by default to keep the footprint small.

The page on Tuning Your Model will help you pick the right configuration for your assistant and alert you to additional dependencies.

Just give me everything!

If you don't mind the additional dependencies lying around, you can use

pip3 install rasa[full]

to install all needed dependencies for every configuration.

Dependencies for spaCy

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

You can install it with the following commands:

pip3 install rasa[spacy]
python3 -m spacy download en_core_web_md

This will install Rasa Open Source as well as spaCy and its language model for the English language, but many other languages are available too. 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 likely reduce intent classification performance.

Dependencies for MITIE

First, run

pip3 install git+
pip3 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).

Upgrading Versions

To upgrade your installed version of Rasa Open Source to the latest version from PyPI:

pip3 install --upgrade rasa

To download a specific version, specify the version number:

pip3 install rasa==3.0