Rasa Pro License
In this section you will learn how to install Rasa Plus, a drop-in replacement enterprise-ready version of Rasa Open Source, on your development environment.
To learn more about deployments, please visit the following sections:
To learn more about compatibility between different versions of Rasa Plus and Rasa Pro Services, please see compatibility matrix.
Rasa Plus Setup
Rasa Plus requires access credentials to install and a license to use. The instructions below assume you have credentials and a license.
Install for Development
Rasa Plus is a drop-in replacement and enterprise-ready version of Rasa Open Source. Additional functionality is provided through plugins while allowing you to continue using the existing Rasa Open Source CLI commands and parameters as you used to.
Installing Rasa Plus instead of Rasa Open Source will not break any existing scripts, automation or functionality you have built around Rasa Open Source.
rasa-plus python packages as well as the docker containers are hosted on our GCP artifact registry.
As a prerequisite, you will need:
- to install and initialize the Google Cloud CLI.
- to verify that the user or service account you are using has the required permissions to access the repository.
In order for the package manager of choice (e.g,
poetry) to have the necessary credentials to authenticate with the registry, follow the steps in the Google documentation.
Where required, input the following parameters:
Enter the following settings to the
Next, add these specific settings to the pip configuration file as instructed in the GCP authentication documentation:
Finally, you should be able to run
pip install rasa-plus.
poetry, you will need to associate the artifact registry URL with
rasa-plus before installing it.
Note that you must upgrade poetry to the latest minor (
1.2.0) in order for
poetry to work with the GCP authentication set-up.
Proceed with the following steps:
poetry self add "keyrings.google-artifactregistry-auth"
- Add this section to
Installing with Docker
To be able to pull the docker using
pull you need to be authenticated first.
Run Rasa Plus locally
Rasa Plus will look for your license in the env var
You can set this env var temporarily in your terminal, but it is recommended
to set it persistently so that you don't have to set it every time you run
Then you can use the
rasa CLI as usual, for example:
If you run
rasa train or
rasa run after you’ve enabled tracing using Jaeger as a backend in your local development environment,
you might come across this error
OSError: [Errno 40] Message too long.
This could be caused by the OS of your local development environment restricting UDP packet size.
You can find out the current UDP packet size by running
sysctl net.inet.udp.maxdgram on macOS.
You can increase UDP packet size by running
sudo sysctl -w net.inet.udp.maxdgram=65535.
Congratulations! You have now succesfully installed Rasa Plus on your developement environment. To learn more about production deployments, visit: