> ## Documentation Index
> Fetch the complete documentation index at: https://rasa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Python

> Install Rasa in your local 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.

## Set Up Your Python Environment

<Info>
  Rasa supports Python `3.11`, `3.12`, `3.13`, and `3.14`. Python `3.14` requires Rasa Pro `3.19` or later. Rasa Pro `3.19` also drops support for Python `3.10`; if you are on Python `3.10`, upgrade your Python version before upgrading Rasa Pro. For detailed information about supported Python versions and dependency groups, see our [Python Versions and Dependencies](/docs/reference/python-versions-and-dependencies) reference page.
</Info>

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

```bash title="Check Python Version" theme={null}
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.

<Tabs>
  <Tab title="macOS and Linux">
    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 theme={null}
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```
  </Tab>

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

    ```bash theme={null}
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    ```
  </Tab>
</Tabs>

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

### 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 theme={null}
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 theme={null}
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

<Tabs>
  <Tab title="macOS and Linux">
    ```bash theme={null}
    source .venv/bin/activate
    ```
  </Tab>

  <Tab title="Windows">
    ```bat theme={null}
    .venv\Scripts\activate
    ```
  </Tab>
</Tabs>

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 theme={null}
uv pip install rasa-pro
```

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

<Tabs>
  <Tab title="macOS and Linux">
    ```bash theme={null}
    export RASA_LICENSE=YOUR_LICENSE_KEY
    ```
  </Tab>

  <Tab title="Windows">
    ```bat theme={null}
    set RASA_LICENSE=YOUR_LICENSE_KEY
    ```
  </Tab>
</Tabs>

Check the Rasa version:

```bash theme={null}
rasa --version
```

Create a new template CALM assistant from a template:

```bash theme={null}
rasa init --template tutorial
```

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


## Related topics

- [Event Brokers](/docs/reference/integrations/event-brokers.md)
- [Writing Custom Actions](/docs/pro/build/custom-actions.md)
- [Rasa Pro Change Log](/docs/reference/changelogs/rasa-pro-changelog.md)
- [Python Versions and Dependencies](/docs/reference/python-versions-and-dependencies.md)
- [Running a Rasa SDK Action Server](/docs/reference/integrations/action-server/running-action-server.md)