updated: 2026-04-10T17:26:56.213031846-07:00[America/Los_Angeles]

README

ry

python bindings for rust crates ~ ry == rust | python

DOCS: ryo3.dev (WIP)

API: ryo3.dev/api

This is a work in progress ~ feedback and PRs are welcome.

Async/Blocking http-clients: Built on reqwest, with a fetch-like API. Supports streaming, zero-copy IO (via the buffer protocol), timeouts, redirect-following, and native JSON (de)serialization.
WebSocket client: Built on tokio-websockets and styled after jawascript’s WebSocket API.
jiff based datetime library: comprehensive datetime library based on jiff (pydantic-compatible).
Async file I/O: AsyncFile API similar to aiofiles and anyio’s async-file api.
(de)compression: (de)compression support for zstd, brotli, gzip, and bzip2.
hashing: aws-lc-rs, fnv, and twox-hash (aka xxhash)
Ergonomic: APIs designed to be ergonomic and pythonic and familiar to both python and rust users.
Type Annotated: All public APIs are (painstakingly) type annotated and checked.
Performant: Speed without the words “blazingly fast.” ¹
Pydantic Integration: ry data types (mostly) work good w/ pydantic.
Not slop: Artisanal, hand-crafted, grassfed, fair-trade, small-batch software.
No emojis
MANY crate bindings see below.

pip install ry
uv add ry
uv pip install ry

# check install
python -m ry
# run & check install w/ uv
uv run --with ry python -m ry

Bop around the ./examples to see some of what ry can do.

Or to play with ry in a repl, run the following:

# repl w/ ipython
uv run --with ry,ipython python -m ry.dev
# repl w/o ipython
uv run --with ry python -m ry.dev

ry – the python package
ryo3-* – the rust crates that are used by ry and possibly your own pyo3-based python package

(aka: questions that I have been asking myself)

Q: Why?
- A: I (jesse) needed several hashing functions for python and then kept adding things as I needed them
Q: Does this have anything to do with the (excellent) package manager rye?
- A: short answer: no. long answer: no, it does not.
Q: Why is the repo split into ry and ryo3?
- A: ry is the python package, ryo3 is a rust crate setup to let you “register” functions you may want if you were writing your own pyo3-python bindings library; maybe someday the ryo3::libs module will be split up into separate packages