reticulate (version 1.18)

conda-tools: Interface to conda


R functions for managing Python conda environments.


conda_list(conda = "auto")

conda_create( envname = NULL, packages = "python", forge = TRUE, channel = character(), conda = "auto" )

conda_remove(envname, packages = NULL, conda = "auto")

conda_install( envname = NULL, packages, forge = TRUE, channel = character(), pip = FALSE, pip_options = character(), pip_ignore_installed = FALSE, conda = "auto", python_version = NULL, ... )

conda_binary(conda = "auto")

conda_version(conda = "auto")

conda_python(envname = NULL, conda = "auto")



The path to a conda executable. Use "auto" to allow reticulate to automatically find an appropriate conda binary. See Finding Conda for more details.


The name of, or path to, a conda environment.


A character vector, indicating package names which should be installed or removed.


Boolean; include the Conda Forge repository?


An optional character vector of Conda channels to include. When specified, the forge argument is ignored. If you need to specify multiple channels, including the Conda Forge, you can use c("conda-forge", <other channels>).


Boolean; use pip when downloading or installing packages? Defaults to FALSE.


An optional character vector of additional command line arguments to be passed to pip. Only relevant when pip = TRUE.


Ignore installed versions when using pip. This is TRUE by default so that specific package versions can be installed even if they are downgrades. The FALSE option is useful for situations where you don't want a pip install to attempt an overwrite of a conda binary package (e.g. SciPy on Windows which is very difficult to install via pip due to compilation requirements).


Optional arguments, reserved for future expansion.


conda_list() returns a data frame with the names and paths to the respective python binaries of available environments. conda_create() returns the path to the python binary of the created environment. conda_binary() returns the location of the main conda binary or NULL if none can be found.

Finding Conda

When conda = "auto", reticulate will attempt to automatically find an Anaconda / Miniconda installation and use that. reticulate will search the following locations:

  1. The location specified by the reticulate.conda_binary R option;

  2. The miniconda_path() location (if it exists);

  3. The program PATH;

  4. A set of pre-defined locations where Conda is typically installed.