Csvglow

by Ratnaditya-J

149 downloads
Not rated
GitHub

Description

# csvglow Generate beautiful, interactive HTML dashboards from CSV/Excel files. One command, zero config. ```bash csvglow sales.csv ``` Opens a self-contained HTML dashboard in your browser with auto-detected charts, smart multi-column insights, correlations, and a sortable data…

About

# csvglow Generate beautiful, interactive HTML dashboards from CSV/Excel files. One command, zero config. ```bash csvglow sales.csv ``` Opens a self-contained HTML dashboard in your browser with auto-detected charts, smart multi-column insights, correlations, and a sortable data table. Dark gradient theme. Copy any…

Details

Author
Ratnaditya-J
Downloads
149
Categories
Other

- Smart multi-column narrative analysis with contradiction detection
- Histograms for numeric columns with stats sidebar
- Bar charts for categorical columns
- Automatic categorical × numeric cross analysis with mean lines
- Time series line charts with area fill for date columns
- Correlation heatmap and scatter plots for highly correlated pairs

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Csvglow
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via pip install csvglow or run directly with npx (npx csvglow data.csv). Use csvglow data.csv to generate a dashboard and open it in the browser. Additional options include -o for a custom output path and --no-open to prevent auto-opening. For MCP server mode, add a configuration entry to your client’s MCP config file (e.g., .cursor/mcp.json) with "command": "npx" and "args": ["-y", "csvglow", "--mcp"] (or "command": "csvglow" if installed via pip).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "csvglow": {
            "csvglow": {
                "command": "npx",
                "args": [
                    "-y",
                    "csvglow",
                    "--mcp"
                ]
            }
        }
    }
}

McpServers

{
    "csvglow": {
        "command": "npx",
        "args": [
            "-y",
            "csvglow",
            "--mcp"
        ]
    }
}

csvglow

Generate beautiful, interactive HTML dashboards from CSV/Excel files. One command, zero config.

csvglow sales.csv

Opens a self-contained HTML dashboard in your browser with auto-detected charts, smart multi-column insights, correlations, and a sortable data table. Dark gradient theme. Copy any chart to your clipboard.

Install

pip install csvglow

Or via npx (no install needed):

npx csvglow data.csv

Usage

csvglow data.csv                    # CSV to dashboard, opens in browser
csvglow report.xlsx                 # Excel works too
csvglow data.csv -o dashboard.html  # Custom output path
csvglow data.csv --no-open          # Don't auto-open browser

What it generates

- Smart findings — multi-column narrative analysis that cross-references metrics to surface contradictions, efficiency gaps, and top/underperformers
- Histograms for every numeric column with mean, median, std, quartiles, and outlier counts
- Bar charts for categorical columns
- Cross analysis — automatic categorical x numeric crosstabs with overall mean lines
- Time series line charts with area fill for date columns
- Correlation heatmap between numeric columns
- Scatter plots for highly correlated pairs (|r| > 0.7)
- Sortable, filterable data table (first 1000 rows)
- Copy button on each chart for pasting into slides

Output is a single self-contained HTML file. No server, no CDN, works offline.

MCP Server

csvglow works as an MCP tool in any MCP-compatible client. Once configured, ask your AI assistant to generate a dashboard from a file path.

Pick your client and add csvglow to its MCP config file:

| Client | Config file location |
|--------|---------------------|
| Cursor | .cursor/mcp.json in your project root |
| Windsurf | ~/.windsurf/mcp.json |

Add this to the config:

{
  "mcpServers": {
    "csvglow": {
      "command": "npx",
      "args": ["-y", "csvglow", "--mcp"]
    }
  }
}

Uses npx so there's nothing extra to install.

If you already have csvglow installed via pip, use "command": "csvglow" with "args": ["--mcp"] instead.

OpenClaw Skill

csvglow is available as an OpenClaw skill. Any OpenClaw-compatible client can discover and use it automatically — no manual config needed.

Supported formats

- .csv / .tsv (auto-detected delimiter)
- .xls
- .xlsx (first sheet only — multi-sheet support coming soon)

Changelog

0.1.0

- Initial release
- Auto-detection of column types (numeric, categorical, datetime, identifier)
- Smart findings: contradiction detection, efficiency analysis, top/underperformer identification across multiple columns
- Histograms with stats sidebar, bar charts, cross-analysis crosstabs, time series, correlation heatmap, scatter plots
- Sortable/filterable data table
- Copy-to-clipboard for all charts
- MCP server mode (csvglow --mcp)
- OpenClaw skill support
- Smart sampling for large files (100k+ rows)

Roadmap

- Multi-sheet Excel support
- Multi-file support with join keys
- Light theme
- Custom color palettes
- PDF export

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.