whatisgithub

What is vizpilot_ai?

zafer-liu/vizpilot_ai — explained in plain English

Analysis updated 2026-05-18

17HTMLAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

In one sentence

A web app that analyzes your CSV or Excel data and uses AI to recommend and generate interactive charts, no chart type expertise required.

Mindmap

mindmap
  root((repo))
    What it does
      Analyzes uploaded data
      Recommends charts
      Generates interactive charts
    Tech stack
      Python
      Flask
      Plotly
    Use cases
      Spreadsheet upload
      Chart recommendation
      Custom chart types
    Audience
      Vibe coders
      Data analysts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Upload a spreadsheet and get AI recommended chart types with reasoning.

USE CASE 2

Generate downloadable interactive HTML charts without writing visualization code.

USE CASE 3

Add a new chart type to the app by registering it in a single registry file.

What is it built with?

PythonFlaskPlotly

How does it compare?

zafer-liu/vizpilot_aiakash190104/kolkata-bus-routecvlab-kaist/worldkv
Stars171717
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyhard
Complexity2/52/55/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs an API key for DeepSeek, MiniMax, or another OpenAI compatible provider.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

VizPilot AI is a web application that helps users create charts from data files without needing to know which chart type is best for their data. You upload a CSV or Excel file, the system analyzes the structure of your data, and an AI model recommends 3 to 5 suitable chart types along with reasoning, a star rating, and suggested field mappings for axes and color. You then pick a chart, and the app generates an interactive HTML visualization that you can download. The backend is built with Flask and the charts are rendered using Plotly, producing interactive HTML output. The AI recommendation step connects to whichever language model provider you configure. The project supports DeepSeek, MiniMax, and any OpenAI-compatible API, with API keys set either via environment variables or through a settings panel in the UI. Chart types are organized in a registry-driven architecture: all chart metadata lives in a single registry.py file, so adding a new chart type only requires creating its implementation files and registering it there. The rest of the app picks it up automatically. The project ships with over 40 chart types across six categories: comparison charts, time-series charts, distribution charts, geospatial maps, relationship charts, and part-to-whole charts. The project documentation is written in both Chinese and English, and includes screenshots of the home page and the AI recommendation results, along with a FAQ section and a contributing guide for developers who want to add chart types or fix bugs. The project is written in Python (3.7+), backed by Flask, and licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
Help me set up VizPilot AI locally with Flask and connect it to an OpenAI compatible API.
Prompt 2
Explain how the registry driven chart architecture in registry.py works.
Prompt 3
Walk me through adding a new chart type to VizPilot AI.
Prompt 4
What chart categories does VizPilot AI support and when should I use each one?

Frequently asked questions

What is vizpilot_ai?

A web app that analyzes your CSV or Excel data and uses AI to recommend and generate interactive charts, no chart type expertise required.

What language is vizpilot_ai written in?

Mainly HTML. The stack also includes Python, Flask, Plotly.

What license does vizpilot_ai use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is vizpilot_ai to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vizpilot_ai for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.