Installing and Configuring Python with Posit


The following steps represent a minimal workflow for using Python with Posit Connect via the reticulate package, whether you are using the RStudio IDE on your local machine or Posit Workbench (previously RStudio Workbench).


Step 1) Install a base version of Python

If you are working on your local machine, you can install Python from or Anaconda.

If you are working on a server with Posit Workbench, your administrator can install a system-wide version of Python, or you can install Python in your home directory from or Anaconda.

Be sure to start a new terminal session to ensure your newly installed Python is active.

Also, ensure that your installation of Python has the virtualenv package installed by running:

pip install virtualenv


Step 2) Create a Python environment in your project

It is recommended that you use one virtual environment per project, similar to how packrat is used to manage R packages within a project.

Navigate into your Posit project directory by using the following command:

cd <project-dir>

Create a new virtual environment in a folder called my_env within your project directory using the following command:

virtualenv my_env


Step 3) Activate your Python environment

You can activate the virtualenv in your project using the following command in a terminal:

source my_env/bin/activate

You can verify that you have activated the correct version of Python using the following command in a terminal:

which python


Step 4) Install Python packages in your environment

You can install Python packages such as numpy, pandas, matplotlib, and other packages in your Python virtualenv by using pip install using the following command in a terminal:

pip install numpy pandas matplotlib


Step 5) Install and configure reticulate to use your Python version

Install the reticulate package using the following command in your R console:


To configure reticulate to point to the Python executable in your virtualenv, create a file in your project directory called .Renviron with the following contents:


You'll need to restart your R session for the setting to take effect. You can verify that reticulate is configured for the correct version of Python using the following command in your R console:



Step 6) Publish a project to Posit Connect

You can then develop Shiny apps, R Markdown, and Plumber APIs with Python/R in the RStudio IDE and  Workbench using the reticulate package per and and deploy the applications to Posit Connect.

For more details on each step, refer to the concepts and best practices in the support article for Best Practices for Using Python with RStudio Connect.