Build your first agent in just a few minutes with [Rasa Copilot](https://hello.rasa.com/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta).

## Set Up Your Python Environment

Rasa 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.

Rasa supports Python `3.10`, `3.11`, `3.12`, and `3.13`. For detailed information about supported Python versions and dependency groups, see our [Python Versions and Dependencies](/content/docs/reference/python-versions-and-dependencies/index.html) reference page.

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

### Check Python Version

```bash
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](https://docs.astral.sh/uv/getting-started/installation/).

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

Install the package manager [uv](https://docs.astral.sh/uv/getting-started/installation/) by executing this command in the Windows Powershell.

```bash
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

### Create Virtual Environment

Python uses [Virtual Environments](https://docs.python.org/3/tutorial/venv.html) 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 project should be started in a new directory.

```bash
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.

```bash
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

```bash
source .venv/bin/activate
```

```bat
.venv\Scripts\activate
```

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

### Install Rasa

Now we are ready to install Rasa. To install the latest version of Rasa with uv, run the command:

```bash
uv pip install rasa-pro
```

Don't forget to obtain your Rasa Developer Edition License from the [license request page](/content/rasa-pro-developer-edition-license-key-request/index.html). Export it as an environment variable:

- macOS and Linux
- Windows

```bash
export RASA_LICENSE=YOUR_LICENSE_KEY
```

```bat
set RASA_LICENSE=YOUR_LICENSE_KEY
```

Check the Rasa version:

```bash
rasa --version
```

Create a new template CALM assistant from a template:

```bash
rasa init --template tutorial
```

That's it - you should now be ready to dive into [building your first bot](/content/docs/pro/tutorial/index.html)!
For troubleshooting tips or FAQs on install see our [troubleshooting guide](/content/docs/pro/installation/troubleshooting/index.html).