Installation¶

River is meant to work with Python 3.11 and above. Installation can be done via pip:

pip install river

And of course with uv:

uv add river

You can install the latest development version from GitHub, as so:

pip install git+https://github.com/online-ml/river --upgrade
pip install git+ssh://git@github.com/online-ml/river.git --upgrade  # using SSH

This method requires having Cython and Rust installed on your machine.

Mini-batch support (optional pandas extra)¶

River's core online interface (learn_one / predict_one) does not require pandas. The mini-batch interface (learn_many, predict_many, predict_proba_many, transform_many) is built on top of pandas.DataFrame and pandas.Series, so pandas is an opt-in dependency.

To install River together with pandas:

pip install "river[pandas]"
# or
uv add "river[pandas]"

If you call a mini-batch method without pandas installed, River raises an ImportError pointing you to this extra.

Feel welcome to open an issue on GitHub if you are having any trouble.