# py-maidr

> py-maidr is a Python library that makes matplotlib, seaborn, and plotly data visualizations accessible to blind and low-vision users through sonification, braille, text, and AI-powered conversational modalities. Developed by the (x)Ability Design Lab at the University of Illinois Urbana-Champaign.

maidr (pronounced "mader") monkey-patches matplotlib, seaborn, and plotly at import time so users just `import maidr` and call `maidr.show(plot)` to generate interactive HTML with keyboard-navigable sonification, braille, text, and AI chat support. Supported plot types: bar, stacked bar, dodged bar, count, histogram, KDE, line, multi-line, box, violin, heatmap, scatter, smooth/regression, candlestick, multi-panel, and facet plots. Works in Jupyter, Colab, VS Code, Streamlit, Shiny, and Quarto.

## Docs
- [Documentation Home](https://py.maidr.ai/): Installation, quick start, and overview
- [Matplotlib/Seaborn Examples](https://py.maidr.ai/examples.html): Code examples for all supported plot types
- [Plotly Examples](https://py.maidr.ai/examples-plotly.html): Plotly-specific accessible plot examples
- [API Reference](https://py.maidr.ai/api/): Complete Python API documentation

## Optional
- [PyPI](https://pypi.org/project/maidr/): Install with `pip install maidr`
- [GitHub](https://github.com/xability/py-maidr): Source code and issue tracker
- [maidr JS Engine](https://maidr.ai/): The core JavaScript library that powers py-maidr
- [maidr for R](https://r.maidr.ai/): The R package counterpart
