gitwtfhub

wtf is datalyze?

huzhe115/datalyze — explained in plain English

Analysis updated 2026-05-18

63PythonAudience · dataComplexity · 3/5LicenseSetup · moderate

TL;DR

Upload a spreadsheet, ask questions in plain language, and get AI generated pie and line charts that update as you chat.

Mindmap

mindmap
  root((repo))
    What it does
      Auto charts from CSV Excel
      Chat to refine charts
      Caches file history
    Tech stack
      React
      FastAPI
      LangChain
      DeepSeek
    Use cases
      Analyze sales data
      Explore car listings
      Check housing prices
    Audience
      Data analysts
      Business users
    Architecture
      Agent picks tools
      Pandas does the math
      Fixed chart JSON contract

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

Why would anyone build with this?

REASON 1

Upload a sales spreadsheet and instantly get a profit breakdown by product as a chart.

REASON 2

Ask in plain language to see quarterly revenue trends and watch the chart update.

REASON 3

Explore any tabular data, such as car sales or housing prices, without setting up columns manually.

REASON 4

Switch between previously uploaded files to revisit earlier analysis results.

What's in the stack?

PythonReactFastAPILangChainDeepSeekpandas

How it stacks up

huzhe115/datalyzefrayude/throttnuxkappaemme-git/codex-bug-reproducer
Stars636363
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedataops devopsdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10+, Node.js 18+, and your own DeepSeek API key to power the chat and analysis.

Use, modify, and share freely under the MIT license.

Wtf does this do

Datalyze is a data analysis assistant that lets a user upload an Excel or CSV file and get automatic charts back, then keep refining those charts through natural language chat. A person drags in a spreadsheet, the tool immediately produces a pie chart and a line chart, and then typing something like look at profit by product or show quarterly trends updates the charts on the spot. Under the hood, a React frontend sends the uploaded file and chat messages to a FastAPI backend, which hands the request to an AI agent built with LangChain and powered by the DeepSeek language model. The agent uses four specific tools: one that reads the structure of the uploaded file, one that groups and aggregates the data, one that analyzes trends over time, and one that turns the results into a fixed JSON format the frontend can render directly as a chart. The language model decides which tools to call and in what order, but the actual number crunching is done by pandas inside those tools, so the model itself never touches the raw data directly. It works with CSV, XLSX, and XLS files and is not tied to any specific column names, so it can be pointed at sales data, car listings, real estate data, or other tables. The project ships with three sample datasets covering sales, car sales, and housing data so a user can try it immediately. Uploaded files are cached so a user can switch back to a previous file's results without re-uploading. Setting it up requires Python 3.10 or newer, Node.js 18 or newer, and a DeepSeek API key, since the chat and analysis are powered by that external model. The backend runs with uvicorn and the frontend with Vite, both locally. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Help me set up Datalyze locally with a DeepSeek API key and run both the backend and frontend.
Prompt 2
Upload the included mock sales data and ask Datalyze to break down profit by product.
Prompt 3
Explain how Datalyze's four agent tools work together to turn a CSV into a chart.
Prompt 4
Show me the JSON contract Datalyze uses to send chart data from the backend to the frontend.

Frequently asked questions

wtf is datalyze?

Upload a spreadsheet, ask questions in plain language, and get AI generated pie and line charts that update as you chat.

What language is datalyze written in?

Mainly Python. The stack also includes Python, React, FastAPI.

What license does datalyze use?

Use, modify, and share freely under the MIT license.

How hard is datalyze to set up?

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

Who is datalyze for?

Mainly data.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.