Install Python Learners

Creates a conda environment and installs the packages required by the Python learners. Installs the dependencies of the fastai auto learner, the tabfm auto learner, and the tabpfn auto learner. The learners share a single environment, so one RETICULATE_PYTHON covers all of them.

Usage

install_python_learners(
  learners = c("fastai", "tabfm", "tabpfn"),
  envname = file.path(tools::R_user_dir("mlr3automl", which = "data"),
    "mlr3automl-python"),
  python_version = "3.12"
)

Arguments

learners

(character())
Learners to install the Python dependencies for. One or more of "fastai", "tabfm", and "tabpfn".

envname

(character(1))
Path to the conda environment directory. Defaults to mlr3automl-python under tools::R_user_dir("mlr3automl", "data").

python_version

(character(1))
Python version to use. Pinned to "3.12" by default so the environment is reproducible across machines.

Value

Invisibly returns the path to the Python binary in the environment.

Details

The environment is created under tools::R_user_dir() by default. The environment can exceed 10GB with torch/CUDA dependencies. The function downloads and installs Python packages and must therefore be called explicitly by the user. It is never called by any other function of the package.

Examples

# The example is wrapped in \dontrun{} because it cannot be executed during checks.
# It downloads and installs conda, a Python interpreter, and several Python packages,
# which requires network access, several GB of disk space, and a few minutes of runtime.
if (FALSE) { # \dontrun{
python = install_python_learners()
Sys.setenv(RETICULATE_PYTHON = python)
} # }