Skip to main content

Using Python

Rasa Pro has a Python package called rasa-pro that you can install locally, with uv package manager. You can use pip but it'll take longer to install.

Set Up Your Python Environment

info

Rasa supports Python 3.10 and 3.11

Check if your Python environment is already configured by ensuring you have Python 3.10 or 3.11.

Check Python Version
python --version
pip --version

If the right packages are already installed, you can skip to the next step.

Otherwise, proceed with the instructions below to install them.

Install the package manager uv by executing this command in the Terminal. Other installation methods are documented in uv documentation.

curl -LsSf https://astral.sh/uv/install.sh | sh

In the next step, we will be using uv to install Python.

Create Virtual Environment

Python uses Virtual Environments to isolate project dependencies. They help avoid conflicts between different projects by creating a clean workspace where you can install specific package versions for each project. We recommend installing rasa-pro within a virtual environment. You can follow the instructions below to set them up,

Each Rasa Pro project should be started in a new directory.

mkdir my-rasa-assistant
cd my-rasa-assistant

Create a new virtual environment with Python 3.11. uv will install Python if it is not already installed.

uv venv --python 3.11

Virtual environments only need to be created once for each project, but you must activate them every time you open a new terminal session to work on your project. Activate the virtual environment

source .venv/bin/activate

This activation step ensures your commands use the project's isolated dependencies rather than your system-wide Python installation.

Install Rasa Pro

Now we are ready to install Rasa Pro:

uv pip install rasa-pro

You can install a specific version of rasa-pro with this command,

uv pip install rasa-pro==3.12.1

Don't forget to obtain your Rasa Pro Developer Edition License from the license request page. Export it as an environment variable:

export RASA_PRO_LICENSE=YOUR_LICENSE_KEY

Check the Rasa version:

rasa --version

Create a new template CALM assistant from a template:

rasa init --template tutorial

That's it - you should now be ready to dive into building your first bot! For troubleshooting tips or FAQs on install see our troubleshooting guide.