data-viz-wizard
Transform CSV data into stunning interactive chart visualizations with Chart.js
Data Viz Wizard
Transform any CSV file into stunning, interactive HTML chart visualizations powered by Chart.js.
Quick Start
# Auto-detect best chart type
python scripts/viz_wizard.py chart sales.csv --type auto --output chart.html
# Generate a full dashboard with multiple charts
python scripts/viz_wizard.py dashboard data.csv --output dashboard.html
# Specify exact chart type and axes
python scripts/viz_wizard.py csv metrics.csv --type line --x date --y revenue --title 'Revenue Trend'
# Pipe data via stdin
cat data.csv | python scripts/viz_wizard.py --auto --output viz.html
Commands
| Command | Description |
|---|---|
chart <file> | Generate a single chart (best auto-detected type) |
dashboard <file> | Generate multi-chart dashboard from same dataset |
csv <file> | Explicit chart with specified type and columns |
| (stdin pipe) | --auto mode reads CSV from stdin |
Flags
| Flag | Description |
|---|---|
--type | Chart type: auto, line, bar, stacked, area, scatter, pie, donut, radar, heatmap-grid |
--x | Column name for X-axis |
--y | Column name(s) for Y-axis (comma-separated) |
--output / -o | Output HTML file path |
--title | Chart title |
--palette | Color palette: viridis, sunset, ocean, monochrome, neon |
--trend | Add trend line |
--moving-average / -ma | Window size for moving average |
--theme | dark, light, or auto (toggleable) |
--auto | Full auto-mode (stdin) |
Column Auto-Detection
The wizard auto-detects column types:
- Date: ISO dates,
YYYY-MM-DD,MM/DD/YYYY, etc. - Numeric: integers, floats, currency
- Percentage: values with
%suffix - Categorical: strings, low-cardinality text
Output Features
Every generated HTML includes:
- Smooth Chart.js animations
- Professional color palettes
- Dark/light theme toggle ( persisted)
- Download chart as PNG button
- Responsive resize
- Smart tooltips (currency, percentage, date formatting)
References
- Chart Selection Guide — Decision tree for choosing the right chart type
- Color Palettes — Palette definitions and when to use each
- Downloads
- Security audit
- Review
- Last updated
- 3mo ago
- Current version
- v0.1.0
- License
- MIT-0
