Below we assume you have the default Python environment already configured on your computer and you intend to install RerF inside of it. We strongly encourage the use of Python virtual environments, please follow instructions on venv and virtual environments.

Make sure you have the latest version of pip (the Python package manager) installed. If you do not, refer to the Pip documentation and install pip first.

Currently RerF is available on Linux and MacOS.

From PyPI

pip install rerf

From source



Make sure you have the appropriate build tools

sudo apt-get install build-essential cmake python3-dev libomp-dev libeigen3-dev   # Ubuntu/Debian


  • Install the SDK headers (Mojave update removes SDK headers)

    open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg
  • Get brew

    /usr/bin/ruby -e "$(curl -fsSL"
  • Get Python 3

    brew install python3
  • Get openmp (for multiprocessing)

    brew install libomp
  • Get llvm

    brew install llvm
  • Get eigen

    brew install eigen
  • Set up paths to use llvm’s clang

    echo ‘export PATH=“/usr/local/opt/llvm/bin:$PATH”’ >> ~/.bash_profile

    Source your .bash_profile

    source ~/.bash_profile

Install (from source)

From PyPI

pip install --no-binary rerf rerf

From GitHub

pip install -e "git+"

Build from source

  • Get the source files

    git clone
  • Navigate to Python directory

    cd RerF/Python
  • Clean out old installation (skip if fresh install)

    python clean --all
  • Build using pip

    pip install -e .