IPython/Jupyter notebook module for Vega 5, and Vega-Lite 4. Notebooks with embedded visualizations can be viewed on GitHub and nbviewer. If you use JupyterLab (not the notebook), you don't need to install this extension since JupyterLab comes with built-in support for Vega and Vega-Lite.
Available on pypi and Conda Forge as
Install and run
Python Package Index
vega and its dependencies from the Python Package Index using
pip, use the following commands:
pip install jupyter pandas vega pip install --upgrade notebook # need jupyter_client >= 4.2 for sys-prefix below jupyter nbextension install --sys-prefix --py vega # not needed in notebook >= 5.3
If you use Conda, you probably already have the latest versions of the notebook and pandas installed. To install
vega extension run:
conda install vega
Once the package is installed, run
to launch the Jupyter notebook server, and use
vega within the notebook. See the example notebooks for Vega-Lite and Vega.
To run the notebooks yourself, you need to get the file
This project uses Poetry. If you prefer a local virtual environment, run
poetry config virtualenvs.in-project true first. Install requirements:
Then activate the virtual environment with
Symlink files instead of copying files:
jupyter nbextension install --py --symlink vega
Run kernel with
jupyter notebook. Run the tests with
How to make a release
package.json(e.g. with ncu).
- Make sure that everything still works (launch notebook and try the examples).
- Update the version number in
poetry version [VERSION]),
__init__.pyand add a git tag.
- Then run
poetry publish --buildto update https://pypi.python.org/pypi/vega.
The Conda feedstock for this package is at https://github.com/conda-forge/vega-feedstock. It should update automatically but we may need to merge a pull request with the updates.