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
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.
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.
- macOS and Linux
- Windows
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
Install the package manager uv by executing this command in the Windows Powershell.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
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
- macOS and Linux
- Windows
source .venv/bin/activate
.venv\Scripts\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:
- macOS and Linux
- Windows
export RASA_PRO_LICENSE=YOUR_LICENSE_KEY
set 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.