---
id: rpds-py
version: "2026.6.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# rpds-py — Python bindings to Rust's persistent data structures (rpds)

License: permissive · Maintenance: active · Popularity: top 100 on PyPI

## Install

pip install rpds-py
uv add rpds-py
poetry add rpds-py

## Description

===========
``rpds.py``
===========

|PyPI| |Pythons| |CI|

.. |PyPI| image:: https://img.shields.io/pypi/v/rpds-py.svg
  :alt: PyPI version
  :target: https://pypi.org/project/rpds-py/

.. |Pythons| image:: https://img.shields.io/pypi/pyversions/rpds-py.svg
  :alt: Supported Python versions
  :target: https://pypi.org/project/rpds-py/

.. |CI| image:: https://github.com/crate-py/rpds/workflows/CI/badge.svg
  :alt: Build status
  :target: https://github.com/crate-py/rpds/actions?query=workflow%3ACI

.. |ReadTheDocs| image:: https://readthedocs.org/projects/referencing/badge/?version=stable&style=flat
   :alt: ReadTheDocs status
   :target: https://referencing.readthedocs.io/en/stable/


Python bindings to the `Rust rpds crate <https://docs.rs/rpds/>`_ for persistent data structures.

What's here is quite minimal (in transparency, it was written initially to support replacing ``pyrsistent`` in the `referencing library <https://github.com/python-jsonschema/referencing>`_).
If you see something missing (which is very likely), a PR is definitely welcome to add it.

Installation
------------

The distribution on PyPI is named ``rpds.py`` (equivalently ``rpds-py``), and thus can be...

## AI interpretation — verify before relying

rpds-py provides Python bindings to Rust's rpds crate, offering persistent (immutable) data structures including hash trie maps, hash trie sets, and linked lists with structural sharing for efficient memory use.

Verdict: rpds-py is a well-maintained, actively developed binding to a mature Rust library, offering high-performance persistent data structures with no runtime dependencies. The MIT license is permissive, and pre-built wheels minimize friction on common platforms. Suitable for projects needing efficient immutable collections, though source builds require Rust.

[View on SkillFed](https://skillfed.io/packages/rpds-py) · [View on PyPI](https://pypi.org/project/rpds-py/)