Awesome
<br/><br/>
<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Dark_Mode.png"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Light_Mode.png"> <img alt="Vizro logo" src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Dark_Mode.png" width="250"> </picture> </p> <br/><br/> <div align="center" markdown="1">
<a href="https://vizro.readthedocs.io/en/stable/" target="_blank">Documentation </a> | <a href="https://vizro.readthedocs.io/en/stable/pages/tutorials/first_dashboard/" target="_blank">Get Started </a> | <a href="http://vizro.mckinsey.com/" target="_blank">Vizro examples gallery</a>
</div><p align="center"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/vizro_spash_teaser.gif" width="600"/> </p> <p align="center"> <font size="+2"> <b> Visual Intelligence. Beautifully Engineered </b> </font> </p> <p align="center"> <font size="+1"> Vizro is a toolkit for creating modular data visualization applications </font> </p> <p align="center"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/tech_logos.png" width="300"/> </p>
What is Vizro?
<p align="left"> <font size="+1"> Rapidly self-serve the assembly of customized dashboards in minutes - without the need for advanced coding or design experience - to create flexible and scalable, Python-enabled data visualization applications. </font> </p> <p align="center"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/code_dashboard.png" width="1300"/> </p>Use a few lines of simple configuration to create complex dashboards, which are automatically assembled using libraries such as Plotly and Dash, with inbuilt coding and design best practices.
Define high-level categories within the configuration, including:
- Components: create charts, tables, input/output interfaces, and more.
- Controls: create filters, parameter inputs, and custom action controllers.
- Pages, layouts and navigation: create multiple pages, with customizable layouts and flexible navigation across them.
- Actions and interactions: create interactions between charts, and use pre-defined or customized actions (such as exporting).
Configuration can be written in multiple formats including Pydantic models, JSON, YAML or Python dictionaries for added flexibility of implementation.
Optional high-code extensions enable almost infinite customization in a modular way, combining the best of low-code and high-code - for flexible and scalable, Python enabled data visualization applications.
Visit "Why should I use Vizro?" for a more detailed explanation of Vizro use cases.
What is Vizro-AI?
Vizro-AI is a separate package and extends Vizro to enable the use of natural language queries to build Plotly charts and Vizro dashboards. With Vizro-AI you can effortlessly create interactive charts and comprehensive dashboards by simply describing your needs in plain English, or any other language.
<p align="center"> <img src="./vizro-ai/docs/assets/readme/readme_animation.gif" alt="Gif to show vizro-ai", width="525" height="296"> </p>See the Vizro-AI documentation for more details.
Key benefits of Vizro
<br/> <p align="center"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/value_prop_icons.png" width="900"/> </p> <br/>Vizro examples gallery
You can see Vizro in action by clicking on the following image or by visiting the examples gallery at vizro.mckinsey.com.
<a href="http://vizro.mckinsey.com/"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/vizro_examples_gallery.png" width="550"> </a>Visual vocabulary
Our visual vocabulary dashboard helps you to select and create various types of charts. It helps you decide when to use each chart type, and offers sample Python code to create these charts with Plotly and embed them into a Vizro dashboard.
<a href="https://vizro-demo-visual-vocabulary.hf.space"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/visual_vocabulary.png" width="550"> </a>Dashboard screenshots
<p align="center"> <img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/dashboard_examples.png" width="1300"/> </p>Installation and first steps
pip install vizro
See the installation guide for more information.
The get started documentation explains how to create your first dashboard.
Get hands on
See the how-to guides for step-by-step instructions on the key Vizro features.
Packages
This repository is a monorepo containing the following packages:
| Folder | Version | Documentation |
|---|---|---|
| vizro-core | | Vizro Docs |
| vizro-ai |  | Vizro-AI Docs |
Community and development
We encourage you to ask and answer technical questions via the GitHub Issues. This is also the place where you can submit bug reports or request new features.
Want to contribute to Vizro?
The contributing guide explain how you can contribute to Vizro.
You can also view current and former contributors.
Want to report a security vulnerability?
See our security policy.
License
vizro is distributed under the terms of the Apache License 2.0