Vizro is a toolkit for creating modular data visualization applications
## What is Vizro?
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.
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.
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?"](https://vizro.readthedocs.io/en/stable/pages/explanation/faq/#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.
See the [Vizro-AI documentation](https://vizro.readthedocs.io/projects/vizro-ai/) for more details.
## Key benefits of Vizro
## 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](https://vizro.mckinsey.com).
## 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](https://plotly.com/python/) and
embed them into a Vizro dashboard.
## Dashboard screenshots
## Installation and first steps
```console
pip install vizro
```
See the [installation guide](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) for more information.
The [get started documentation](https://vizro.readthedocs.io/en/stable/pages/tutorials/first-dashboard/) explains how to create your first dashboard.
## Get hands on
See the [how-to guides](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) 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-core) | [](https://badge.fury.io/py/vizro) | [Vizro Docs](https://vizro.readthedocs.io/en/stable/) |
| [vizro-ai](./vizro-ai) | [](https://badge.fury.io/py/vizro-ai) | [Vizro-AI Docs](https://vizro.readthedocs.io/projects/vizro-ai/) |
## Community and development
We encourage you to ask and answer technical questions via the [GitHub Issues](https://github.com/mckinsey/vizro/issues). This is also the place where you can submit bug reports or request new features.
## Want to contribute to Vizro?
The [contributing guide](https://vizro.readthedocs.io/en/stable/pages/explanation/contributing/) explain how you can contribute to Vizro.
You can also view current and former [contributors](https://vizro.readthedocs.io/en/stable/pages/explanation/authors/).
## Want to report a security vulnerability?
See our [security policy](https://github.com/mckinsey/vizro/security/policy).
## License
`vizro` is distributed under the terms of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
## 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](https://plotly.com/python/) and
embed them into a Vizro dashboard.
## Dashboard screenshots
