Install Reahl

This version of Reahl requires version 3.6 of Python or greater.

Reahl depends on a lot of other software. Installing it is not just a straight python -m pip install reahl. You need to install a couple of other things first.

If you know Docker then use our Docker dev box. It contains a virtualenv with Reahl installed. Otherwise, follow the instructions below:

  1. Prepare your platform

  1. Create a virtualenv

    On Linux or Mac, do:

    python3 -m venv ./reahl_env

    On Windows, do (in a command shell):

    python3 -m venv reahl_env

    This creates a new directory reahl_env with an isolated Python environment inside it.

  2. Activate the virtualenv

    On Linux or Mac:

    source ./reahl_env/bin/activate

    On Windows:


    Your prompt should change to reflect the active virtual environment.

  3. Install Reahl in the virtualenv

    With your virtualenv activated, install Reahl:

    python -m pip install reahl[declarative,sqlite,dev,doc]

    Reahl is composed of different components—you only need some of them. The pip extras (given in [] above) let you choose what to install.

    You can install:


    The SqlAlchemy declarative implementation of the web framework


    The development tools


    Documentation and examples


    Support for sqlite databases


    Support for postgresql databases


    Support for MySQL databases


    You need pip > 6 (for wheel support) on Windows.

Previous topic

Web framework tutorial