Skip to content

reticulate

1.47.0Package record

Interface to 'Python'

242packages dependsuggested by 107
2.7Mdownloads / year
54.7%test coverage
13/13flavors OK

Overview

About

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.

Changes in 1.47.0

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() and uv_run_tool() now accept Date and POSIXt objects for exclude_newer.
  • py_require() now updates sys.executable and an already-loaded multiprocessing launcher after a live activation, so child Python processes can import newly added packages.
  • RETICULATE_MAX_CACHE_AGE_DAYS can now configure the maximum age, in days, of reticulate's managed uv cache before it is cleared (#1905).
Show all changes in 1.47.0Hide the rest of the changes in 1.47.0
  • Managed uv bootstrapping now works on Windows when R inherits a PowerShell 7 PSModulePath, such as from GitHub Actions pwsh steps.
  • Pipenv interpreter discovery now uses a located Pipfile even when here cannot resolve a project root (#1909).
  • Reticulate now treats projects with a pyproject.toml but no [tool.poetry] section, such as uv or PEP 621 projects, as non-Poetry projects (#1900).
  • Reticulate now retains an expired managed uv cache 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 abort restart to a Python exception instead of jumping to R's top level.
  • Reticulate now builds with Clang 21 without a spurious -Wnonnull compiler warning (#1917).

Documentation

  • The py_require() documentation now explains how R_USER_CACHE_DIR configures the location of reticulate's managed uv cache (#1899).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 4.6 min · r-devel-windows-x86_64
Status changes
  • 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
Advisories

none known

Documentation

In release 1.47.0
README· In the repository, left out of the releaseVignettesYes · 8 · staticNEWSYes · 100% structured · mentions 1.47.0Citation fileNoWebsiteYes · pkgdown
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

2.7M
CRAN downloads in the past year
Rank #240 · ~7.4K/day · ~224.8K/mo
Daily download trend is not available in this view yet.
173.4K30 days
546.6K90 days
2.7M1 year
Compare downloads with other packages →
Also on57.8K r2u183 autocran324.6K conda_forge1.9K c2d4u

Repository

1,764Stars
348Forks
466Open issues
11Open PRs
24Releases
4,024Commits
95Commit identities
License file reads as Apache-2.0 · 4,024 commits · Last activity 2026-10-16 · +0.3% stars, 30d · Default branch at 1.47.0.9000, ahead of CRAN 1.47.0 (checked 2026-10-11)
Responsiveness
How these are sampled
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

2025-10-13 · 1,7172026-10-14 · 1,764
PracticesBeta

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.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (1)
Issue templates
Docs source (3)
pkgdown

GitHub Pages site last deployed 2026-09-09 · The repository has a site deploy workflow

pkgdown site last built 2026-09-03

CRAN release process (1)
cran-comments.md
Show all practicesHide 2 practices
Lint, format, editor (1)
RStudio project
Git structural (1)
blame-ignore revs
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • GitHub Copilotfirst seen 2025-09-10
    Pull request: opened by its own account
  • Claude Codefirst seen 2026-01-29
    Commits: at least 2 crediting it in the message
From outside contributors
  • Claude Code
    Pull requests: 1 from outside contributors, first on 2026-01-29
Models named in its commits
  • Claude Opus 4.52 commits · Jan 2026
Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
16 external dependencies (excludes base and recommended)

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.

Depends (1)
R >= 3.5
Imports (12)
LinkingTo (1)
Enhances (0)
none

People & History

People (10)
Author, Maintainer since 1.25 (2022) · added in 1.25
Author, Copyright holder
Contributor, Copyright holder
Contributor, Copyright holder
TinyThread library, http://tinythreadpp.bitsnbites.eu/
Contributor, Copyright holder · added in 1.14
Contributor · added in 1.15
Contributor, Copyright holder
Copyright holder, Funder · added in 0.8

Previously maintained by Kevin Ushey (1.12 to 1.24) and JJ Allaire (0.7 to 1.11.1).

Releases (55)

Pick two releases to compare their code metrics.

Show 50 earlier eventsHide 50 earlier events
  • 1.36.1
    record
    2024-04-23 · diff ↗
  • 1.36.0
    record
    2024-04-15 · diff ↗ ·
    added 1 export
    is_py_object
  • 1.35.0
    record
    2024-01-31 · diff ↗
  • 1.34.0
    record
    2023-10-13 · diff ↗ ·
    added 1 export
    condaenv_exists
  • 1.32.0
    record
    2023-09-11 · diff ↗
  • 1.31
    record
    2023-08-10 · diff ↗ ·
    added 2 exports
    conda_search, virtualenv_starter
  • 1.30
    record
    2023-06-10 · diff ↗
  • 1.29
    record
    2023-06-05 · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • 1.28
    record
    2023-01-27 · diff ↗
  • 1.27
    record
    2023-01-07 · diff ↗
  • 1.26
    record
    2022-08-31 · diff ↗
  • 1.25
    record
    2022-05-11 · diff ↗ ·
    added 1 export
    py_repr
  • R
    R 4.2.0 released · 2022-04-22
  • 1.24
    record
    2022-01-26 · diff ↗
  • 1.23
    record
    2022-01-14 · diff ↗ ·
    added 7 exports
    conda_clone, conda_exe, conda_export, conda_update, miniconda_uninstall, py_bool, py_list_packages
  • 1.22
    record
    2021-09-17 · diff ↗
  • 1.21
    record
    2021-09-14 · diff ↗
  • R
    R 4.1.0 released · 2021-05-18
  • 1.20
    record
    2021-05-03 · diff ↗
  • 1.19
    record
    2021-04-21 · diff ↗ ·
    added 5 exports
    install_python, py_exe, py_version, use_python_version, virtualenv_exists
  • 1.18
    record
    2020-10-25 · diff ↗
  • 1.17
    record
    2020-10-21 · diff ↗ ·
    added 3 exports
    py_del_attr, py_help_handler, py_none
  • 1.16
    record
    2020-05-27 · diff ↗
  • R
    R 4.0.0 released · 2020-04-24
  • 1.15
    record
    2020-04-02 · diff ↗ ·
    added 1 export
    py_ellipsis
  • 1.14
    record
    2019-12-17 · diff ↗ ·
    added 6 exports
    PyClass, configure_environment, install_miniconda, miniconda_path, miniconda_update, use_miniconda
  • 1.13
    record
    2019-07-25 · diff ↗
  • R
    R 3.6.0 released · 2019-04-26
  • 1.12
    record
    2019-04-12 · diff ↗
  • 1.11.1
    record
    2019-03-06 · diff ↗
  • 1.11
    record
    2019-02-27 · diff ↗ ·
    added 1 export
    py_main_thread_func
  • 1.10
    record
    2018-08-05 · diff ↗ ·
    added 3 exports
    as_iterator, conda_python, virtualenv_python
  • 1.9
    record
    2018-07-06 · diff ↗
  • 1.8
    record
    2018-06-08 · diff ↗ ·
    added 3 exports
    py_del_item, py_get_item, py_set_item
  • 1.7
    record
    2018-04-28 · diff ↗ ·
    added 2 exports
    py_func, py_install
  • R
    R 3.5.0 released · 2018-04-23
  • 1.6
    record
    2018-03-21 · diff ↗ ·
    added 7 exports
    py_dict, repl_python, virtualenv_create, virtualenv_install, virtualenv_list, virtualenv_remove, virtualenv_root
  • 1.5
    record
    2018-02-14 · diff ↗ ·
    added 1 export
    source_python
  • 1.4
    record
    2018-01-09 · diff ↗
  • 1.3.1
    record
    2017-11-24 · diff ↗
  • 1.3
    record
    2017-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
    record
    2017-09-27 · diff ↗ ·
    added 2 exports
    np_array, py_set_seed
  • 1.1
    record
    2017-08-26 · diff ↗ ·
    added 1 export
    register_module_help_handler
  • 1.0
    record
    2017-07-26 · diff ↗ ·
    added 1 export
    py_iterator
  • 0.9
    record
    2017-06-23 · diff ↗ ·
    added 3 exports
    conda_version, iter_next, py_help
  • 0.8
    record
    2017-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
  • R
    R 3.4.0 released · 2017-04-21
  • 0.7
    record
    2017-03-14
  • R
    R 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")
Kalinowski, T., RStudio, Allaire, J., Eddelbuettel, D., Geelnard, M., Hafen, R., Keydana, S., Lewis, B., Tang, Y., & Ushey, K. (2026). reticulate: Interface to 'Python' (Version 1.47.0) [Computer software]. https://doi.org/10.32614/CRAN.package.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.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for reticulate version 1.47.0 [Data set]. HJJB, LLC. Data release v2026-10-19. https://doi.org/10.5281/zenodo.21843040

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.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy