Lumen works with Python 3 on Linux, Windows, and Mac.

The recommended way to install Lumen is using the conda command that is included in the installation of Anaconda or Miniconda. To help you choose between Anaconda and Miniconda, review this page. Completing the installation for either Anaconda or Miniconda will also install Python.

If you are not installing Anaconda or Miniconda, you can download Python directly from In this case, you can install Lumen using pip, which comes with Python.

Installing Lumen#

  1. Open up a terminal (Powershell if you are on Windows).

  2. Run the following command, which will install Lumen with all its dependencies.

  3. When the command finishes, run lumen --version in the terminal and check that the version is 0.5.1.

    • If this is not the case, you are not running the latest version, which may cause problems.

conda install -c pyviz -c conda-forge lumen -y
pip install lumen

Optional dependencies#

Lumen is very flexible and allows you to use components from various packages. Depending on what type of dashboard components you use, you may need to install additional packages. Error messages will help you determine if you are missing a package. For instance, if you see the following:

Source component specification declared unknown type 'intake'.

install the missing package in the same way you did lumen:

conda install -c pyviz -c conda-forge intake -y
pip install intake