Interface to 'Python'
Overview
Interface to 'Python' modules, classes, and functions. When calling into 'Python', R data types are automatically converted to their equivalent 'Python' types. When values are returned from 'Python' to R they are converted back to R types. Compatible with all versions of 'Python' >= 2.7.
Python requirements and environments
py_require()now applies late package additions atomically. Failed package-originated additions warn without changing the declared requirements. Its printed summary now shows successful requirement requests in chronological order, including their source and action.py_require()anduv_run_tool()now acceptDateandPOSIXtobjects forexclude_newer.py_require()now updatessys.executableand an already-loadedmultiprocessinglauncher after a live activation, so child Python processes can import newly added packages.RETICULATE_MAX_CACHE_AGE_DAYScan now configure the maximum age, in days, of reticulate's manageduvcache before it is cleared (#1905).
Show all changes in 1.47.0Hide the rest of the changes in 1.47.0
- Managed
uvbootstrapping now works on Windows when R inherits a PowerShell 7PSModulePath, such as from GitHub Actionspwshsteps. - Pipenv interpreter discovery now uses a located Pipfile even when
herecannot resolve a project root (#1909). - Reticulate now treats projects with a
pyproject.tomlbut no[tool.poetry]section, such as uv or PEP 621 projects, as non-Poetry projects (#1900). - Reticulate now retains an expired managed
uvcache when it cannot download the installer needed to replace it (#1876).
Conversion
py_to_r()now converts pandas data frames and series containing Arrow-backed string columns (#1910).r_to_py()now preserves explicit integer row names as the index when converting an R data frame to a pandas data frame (#1924).
Other improvements and fixes
- Child processes created by
os.fork()now use Python's original output streams when output remapping is enabled. - Python calls to R now convert base R's built-in
abortrestart to a Python exception instead of jumping to R's top level. - Reticulate now builds with Clang 21 without a spurious
-Wnonnullcompiler warning (#1917).
Documentation
- The
py_require()documentation now explains howR_USER_CACHE_DIRconfigures the location of reticulate's manageduvcache (#1899).
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK12 OK, 1 FAILURE2026-06-08
- ERROR12 OK, 1 ERROR2026-06-07
- OK13 OK2026-05-02
Show 5 earlier changesHide 5 earlier changes
- NOTE12 OK, 2 NOTE2026-04-22
- ERROR11 OK, 2 NOTE, 1 ERROR2026-04-18
- NOTE12 OK, 2 NOTE2026-04-16
- WARNING7 OK, 6 NOTE, 1 WARNING2026-03-21
- NOTE12 OK, 2 NOTE2026-03-10
Documentation
- Help pages
- 80 (17 internal)includes a package overview page
- Examples that run
- 22%2 run in a plain check (2 of them under a condition) · 7 never run
- Exported functions with examples
- 7%
- Documented parameters
- 93%
- Return-value docs
- 56%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 91%
- Median days to close, 50 most recently updated closed issues
- 6
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
9 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/rstudio/reticulate on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-09-09 · The repository has a site deploy workflow
pkgdown site last built 2026-09-03
Show all practicesHide 2 practices
This repository shows signs of AI coding tools.
- GitHub Copilotfirst seen 2025-09-10Pull request: opened by its own account
- Claude Codefirst seen 2026-01-29Commits: at least 2 crediting it in the message
- Claude CodePull requests: 1 from outside contributors, first on 2026-01-29
- Claude Opus 4.52 commits · Jan 2026
Dependencies
Installing reticulate adds 9 packages (6 with compiled code, 3.9 MB of source tarballs). Heaviest: Rcpp 1.8 MB, jsonlite 1.0 MB, rlang 766 KB.
Show the 48 most downloaded dependentsHide the 48 most downloaded dependents
and 194 more dependents and 107 packages that suggest it on CRAN ↗
Code & Tests
People & History
Previously maintained by Kevin Ushey (1.12 to 1.24) and JJ Allaire (0.7 to 1.11.1).
Pick two releases to compare their code metrics.
- 1.47.0Latest
- RR 4.6.0 released · 2026-04-24
- 1.46.02026-04-09 · diff ↗
- 1.45.02026-02-13 · diff ↗
- 1.44.12025-11-15 · diff ↗
- 1.44.0
- 1.43.02025-07-21 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 1.42.0
- 1.41.0.12025-03-09 · diff ↗
- 1.41.0
- 1.40.02024-11-15 · diff ↗
- 1.39.0
- 1.38.02024-06-19 · diff ↗
- 1.37.02024-05-21 · diff ↗
- RR 4.4.0 released · 2024-04-24
Show 50 earlier eventsHide 50 earlier events
- 1.36.12024-04-23 · diff ↗
- 1.36.0
- 1.35.02024-01-31 · diff ↗
- 1.34.0
- 1.32.02023-09-11 · diff ↗
- 1.31
- 1.302023-06-10 · diff ↗
- 1.292023-06-05 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 1.282023-01-27 · diff ↗
- 1.272023-01-07 · diff ↗
- 1.262022-08-31 · diff ↗
- 1.25
- RR 4.2.0 released · 2022-04-22
- 1.242022-01-26 · diff ↗
- 1.232022-01-14 · diff ↗ ·
added 7 exports
conda_clone, conda_exe, conda_export, conda_update, miniconda_uninstall, py_bool, py_list_packages - 1.222021-09-17 · diff ↗
- 1.212021-09-14 · diff ↗
- RR 4.1.0 released · 2021-05-18
- 1.202021-05-03 · diff ↗
- 1.192021-04-21 · diff ↗ ·
added 5 exports
install_python, py_exe, py_version, use_python_version, virtualenv_exists - 1.182020-10-25 · diff ↗
- 1.17
- 1.162020-05-27 · diff ↗
- RR 4.0.0 released · 2020-04-24
- 1.15
- 1.142019-12-17 · diff ↗ ·
added 6 exports
PyClass, configure_environment, install_miniconda, miniconda_path, miniconda_update, use_miniconda - 1.132019-07-25 · diff ↗
- RR 3.6.0 released · 2019-04-26
- 1.122019-04-12 · diff ↗
- 1.11.12019-03-06 · diff ↗
- 1.11
- 1.10
- 1.92018-07-06 · diff ↗
- 1.8
- 1.7
- RR 3.5.0 released · 2018-04-23
- 1.62018-03-21 · diff ↗ ·
added 7 exports
py_dict, repl_python, virtualenv_create, virtualenv_install, virtualenv_list, virtualenv_remove, virtualenv_root - 1.5
- 1.42018-01-09 · diff ↗
- 1.3.12017-11-24 · diff ↗
- 1.32017-11-16 · diff ↗ ·
added 8 exports
array_reshape, eng_python, py, py_id, py_len, py_load_object, py_save_object, py_to_r_wrapper - 1.2
- 1.1
- 1.0
- 0.9
- 0.82017-05-22 · diff ↗ ·
added 15 exports
conda_binary, conda_create, conda_install, conda_list, conda_remove, import_from_path, py_clear_last_error, py_config_error_message, py_discover_config, py_eval, py_function_docs, py_function_wrapper, py_last_error, py_versions_windows, register_class_filter - RR 3.4.0 released · 2017-04-21
- 0.72017-03-14
- RR 3.3.0 released · 2016-05-03
Package metadata
- First published
- 2017-03-14
- Total releases
- 55 / 9 yrs
- License
- Apache License 2.0 OSI
- Minimum R
- ≥ 3.5
- Download size
- 1.6 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("reticulate")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.