---
title: README
emoji: 🏃
colorFrom: blue
colorTo: gray
sdk: static
pinned: false
---

<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>

<div align="center" markdown="1">

<a href="https://github.com/mckinsey/vizro/" target="_blank">GitHub </a> |
<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="https://py.cafe/snippet/vizro/v1" target="_blank">Try out live in Browser </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">
Visual Intelligence. Beautifully Engineered
</font>
</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="1000"/>
</p>

Use a few lines of simple configuration to create complex dashboards, which are automatically assembled using libraries such as [**Plotly**](https://github.com/plotly/plotly.py) and [**Dash**](https://github.com/plotly/dash), with inbuilt coding and design best practices.


<h2>✨ Contributing Demos and Showcasing Your Work ✨</h2>

<ul style="list-style-type: none;">
  <li>
    <p>🔥 <strong>Deploy Vizro to Huggingface and elsewhere:</strong> If you are not sure on how to proceed, 
    <a href="https://vizro.readthedocs.io/en/stable/pages/user-guides/run-deploy/#deploy-to-hugging-face" target="_blank">visit our docs guide</a> 
  </li>
  <li>
    <p>🎨 <strong>Showcase Your Vizro App:</strong> If you'd like us to feature your Vizro app on this page, 
    <a href="https://github.com/mckinsey/vizro/issues/new/choose" target="_blank">contact us on GitHub</a> 
  </li>
  <li>
    <p>💡 <strong>Contribute to Our Demos:</strong> If you want to suggest improvements to one of our demos, 
    <a href="https://huggingface.co/docs/hub/repositories-pull-requests-discussions" target="_blank">we welcome your PRs</a> 
  </li>

</ul>