This website is for version 5. You can find the documentation for version 4 here.


Altair can be installed, along with all its optional dependencies, using:

pip install "altair[all]"

If you are using the conda package manager, the equivalent is:

conda install -c conda-forge altair-all

At this point, you should be able to open any IDE compatible with Jupyter Notebooks, and execute any of the code from the Example Gallery. For more information on how to display charts in various notebook environments and non-notebook IDEs, see Displaying Altair Charts. If you wish to install Altair with only the required dependencies, you can omit the [all]/-all suffix.

Development Installation#

The Altair source repository is available on GitHub. Once you have cloned the repository and installed all the above dependencies, run the following command from the root of the repository to install the main version of Altair:

pip install -e .

To install optional and development dependencies as well, run

pip install -e ".[all, dev]"

If you do not wish to clone the source repository, you can install the development version directly from GitHub using:

pip install -e git+

Please see for details on how to contribute to the Altair project.