Vizflow

A data visualization pipeline tool for fast schema inspection, charting, dashboards, and export.

Vizflow turns raw CSV, JSON, Parquet, SQLite, SQL script, and piped stdin data into useful visual outputs without writing boilerplate notebooks. It profiles column types, recommends chart families, generates Plotly-powered interactive charts, serves local browser previews, combines charts into dashboards, converts datasets between common formats, and produces comparison reports for changing data files.

• Automatic schema inspection — detect semantic column types, null counts, unique values, samples, and numeric/date statistics.
• Smart chart suggestions — recommend line, bar, scatter, pie, heatmap, treemap, and histogram views from the data shape.
• Interactive Plotly charts — generate browser-ready HTML or static PNG/SVG/PDF exports with x/y/color controls.
• Dashboard mode — combine multiple chart specs into a responsive standalone HTML page.
• Local preview server — launch a Flask web server for charts, dashboards, schema, and sample-data browsing on localhost.
• Data conversion and comparison — convert CSV/JSON/Parquet inputs and compare two datasets visually.
• Pipe support — stream CSV or JSON directly into commands with cat data.csv | vizflow plot.

Installation

pip install vizflow-cli

For local development:

git clone https://github.com/shazeus/vizflow-cli.git
cd vizflow-cli
pip install -e .

Usage

Inspect a dataset:

vizflow schema examples/sales.csv

Create an auto-selected chart:

vizflow plot examples/sales.csv --output sales-chart.html

Create a specific chart:

vizflow plot examples/sales.csv --type line --x date --y revenue --color region

Build a dashboard:

vizflow dashboard examples/sales.csv --charts "bar:region:revenue,line:date:revenue,pie:category:revenue"

Convert a file:

vizflow convert examples/sales.csv --to json --output sales.json

Preview in a browser:

vizflow serve examples/sales.csv --port 5050

The preview server exposes chart suggestions, /dashboard, /schema, and /data routes for quick browser inspection.

Use stdin:

cat examples/sales.csv | vizflow plot --type bar --x region --y revenue --output piped.html

Commands

Configuration

Vizflow is intentionally CLI-first and does not require a config file. Common options are available directly on commands:

Static image export uses Plotly's Kaleido engine when available. If the local browser runtime is unavailable, Vizflow falls back to a Matplotlib renderer for PNG, SVG, and PDF outputs.

License

MIT License. See LICENSE.