Project Info
Tired of spending 70% of your time cleaning data? Jade.AI is an intelligent, all-in-one platform that lets you clean, analyze, and visualize your data using simple English commands. No code, no app-switching -- just results.
Inspiration
As a college student passionate about data analysis, I’ve faced a frustrating reality: most of my project time isn't spent on analysis. It's spent on grunt work. I often wasted over 70% of my time just cleaning messy datasets. I was constantly switching between Excel for quick fixes, Pandas for heavy-duty cleaning, SQL for data pulling, and another tool like Tableau for visualization. The process was slow, exhausting, and fragmented. I wanted a single, intelligent, all-in-one solution that could handle all these tasks with just a few natural language commands. I envisioned a "Cursor for data analysis", an AI-first tool that would let me talk to my data. That's why we built Jade.AI.
What it does
Jade.AI empowers anyone, regardless of their technical background, to work with data effortlessly. It’s as simple as 1-2-3: Upload your data (CSV, Excel, etc.). Type what you want in plain English. Get immediate results. You can clean, manipulate, visualize, and summarize, all in one seamless interface: “Clean the entire dataset” → Jade.AI intelligently handles missing values, removes duplicates, fixes inconsistent formatting, and standardizes data types. “Show a pie chart of the gender distribution” → Instantly generates a beautiful, interactive chart with auto-labeled insights. “What’s the average salary by department?” → Returns a clean summary table or a bar chart, your choice. “Summarize the key findings from this data” → Creates a concise, human-readable report.
How we built it
We built Jade.AI to be fast, intelligent, and scalable. Frontend: We built a clean and responsive UI using Next.JS to create a seamless, single-page application experience. Backend: We used a Python (FastAPI) backend to create REST APIs that handles all user requests. LLM: We integrated the Groq API as the main LLM to power our natural language-to-action engine. Its incredible speed makes the conversation feel instantaneous. This model interprets user commands and translates them into executable operations. Data Manipulation: The legendary Pandas library is our workhorse. All data cleaning, transformation, and analysis commands are piped through a secure Pandas runtime. Data Visualization: We used Chart.js to generate rich, interactive, and beautiful visualizations that can be embedded directly in the chat interface.
Challenges we ran into
Prompt Engineering is Deceptive: Getting the LLM to consistently and safely translate a vague command like "fix the messy columns" into the correct sequence of Pandas functions was our biggest hurdle. It required lots of iterative prompt design and building a robust validation layer. Maintaining Data State: Managing the state of a user's DataFrame across multiple, independent API calls was a huge challenge. Our initial implementation was slow and buggy before we used Groq. The Scope Creep: We had so many ideas! We wanted to add SQL database connections, advanced statistical modeling, and more. Focusing on our core loop (Upload → Clean → Analyze → Viz) within the time limit was a real test of discipline.
Accomplishments we're proud of
It Actually Works! We have a fully functional, end-to-end demo. You can upload a genuinely messy dataset and walk away with clean data and insightful charts in under two minutes. The "Wow" Moment: The biggest win was testing it on a friend with zero coding experience. They were able to perform a complete data analysis task that would have taken them hours, and they did it with a smile. The "Cursor for Data" Feel: We successfully captured that "magic" feeling. It feels less like a tool and more like an intelligent collaborator, which was our core vision.
What we learned
LLMs are Interpreters, Not Magicians: The real magic isn't just the LLM; it's the pipeline. The most critical work is building the robust "plumbing" that translates the LLM's intent into safe, executable code. UX is Everything: For a tool aimed at non-technical users, simplicity is the ultimate feature. A single, clear chat box proved to be infinitely more powerful than a complex dashboard. Speed is a Feature: Using an incredibly fast LLM (Groq) was a game-changer. When the analysis feels instant, it encourages creativity and exploration, which is the entire point of data analysis.
What's next
We're just getting started. Our vision is to make data analysis as easy as having a conversation. More Data Connectors: We plan to add support for connecting directly to SQL databases, Google Sheets, and other live APIs. Advanced Analytics: We're working on moving beyond descriptive statistics to include predictive modeling. (e.g., "Forecast next quarter's sales based on this data"). "Analysis History": We want to create a feature that lets users track, revert, and branch their analysis steps, almost like Git for data analysis.
This repository has no readme, or GitHub could not be reached.
Analysis
View
Metric
- 3
- 3
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- FastAPIIn code
- Next.jsIn code
- PythonIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
7 of 7 appear in the indexed code.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
253 KB
Source files
56
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
erik-ksth/jade-ai
83 files · 2.5 MB · @ c189c56
Structure
Interface
17 files · 20%Screens, components and styles rendered to the user.
API & routing
7 files · 8%Request entry points: routes, handlers and controllers.
Application logic
29 files · 35%Domain rules, services and shared utilities.
+3 more
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- TypeScript56%
- Python34%
- Markdown6%
- CSS5%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
backend/requirements.txt
pypi · 40- annotated-types
- anyio
- cachetools
- certifi
- charset-normalizer
- click
- et_xmlfile
- fastapi
- groq
- h11
- httpcore
- httpx
- idna
- langchain-core
- langchain-groq
- langgraph
- numpy
- openpyxl
- +22 more
frontend/package.json
npm · 34- @radix-ui/react-alert-dialog
- @radix-ui/react-dialog
- @radix-ui/react-dropdown-menu
- @radix-ui/react-slot
- ag-grid-community
- ag-grid-react
- chart.js
- class-variance-authority
- clsx
- lucide-react
- next
- next-themes
- react
- react-chartjs-2
- react-dom
- react-markdown
- react-resizable-panels
- react-rnd
- +16 more
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
Feature verification
AI-driven data cleaning (missing values, duplicates, formatting, dtypes)Verified
'Clean the entire dataset' handles missing values, removes duplicates, fixes inconsistent formatting, and standardizes data types
Claimed on Devposthigh confidencebackend/workflows/cleaning_orchestrator.py:39— generate_batch_fix_code builds prompts to fix high/medium/low priority issues iterativelybackend/aiAgent.py:398— assess_data_quality detects missing values, duplicates, empty columns, and dtype issues
Chart generation from natural language (pie, bar, etc.)Verified
'Show a pie chart of the gender distribution' instantly generates an interactive chart
Claimed on Devposthigh confidencebackend/aiAgent.py:193— System prompt instructs LLM to produce chart_data_result dict with type/labels/data for many chart typesbackend/services/chart_service.py:41— format_chart_data formats raw chart_data_result into Chart.js-ready datasetfrontend/src/components/Dashboard.tsx:9— Chart.js and react-chartjs-2 are registered and used to render charts
Chart.js visualizationsVerified
Used Chart.js to generate rich, interactive, and beautiful visualizations embedded in the chat interface
Claimed on Devposthigh confidencefrontend/src/components/Dashboard.tsx:9— Imports and registers Chart.js and react-chartjs-2, renders charts with renderChartfrontend/package.json— chart.js listed as dependency
CSV/Excel data uploadVerified
Upload your data (CSV, Excel, etc.)
Claimed on Devposthigh confidencebackend/api/routes/upload_routes.py:11— /upload endpoint validates and parses CSV or Excel filesbackend/services/file_service.py:12— parse_csv and parse_excel implement actual file parsing with pandas
FastAPI Python backend with REST APIsVerified
Backend: Python (FastAPI) backend with REST APIs handling all user requests
Claimed on Devposthigh confidencebackend/main.py— FastAPI app entrypointbackend/requirements.txt:8— fastapi==0.118.0 dependency present
Groq API as LLM engineVerified
Integrated the Groq API as the main LLM to power the natural language-to-action engine
Claimed on Devposthigh confidencebackend/aiAgent.py:5— Groq client imported and used with GROQ_API_KEY for chat completionsbackend/requirements.txt:9— groq==0.33.0 dependency present
Natural language chat interface for data commandsVerified
Type what you want in plain English and get immediate results via a chat interface
Claimed on Devposthigh confidencebackend/api/routes/chat_routes.py:17— Streaming /chat/stream endpoint runs a LangGraph workflow on user_messagefrontend/src/components/ChatAgent.tsx— Frontend chat component exists to send user messages to backend
Next.js frontendVerified
Frontend built with Next.JS for a seamless single-page application experience
Claimed on Devposthigh confidencefrontend/package.json:23— next 15.5.4 dependency and next dev/build/start scripts
Pandas-based data manipulation runtimeCode-supported
All data cleaning, transformation, and analysis commands are piped through a secure Pandas runtime
Claimed on Devpostmedium confidencebackend/tools/code_executor.py:12— execute() runs LLM-generated code against a pandas DataFrame using exec(); validate() only blocks a small denylist of substrings (import os, eval, subprocess, etc.), which is weak sandboxing, not a genuinely secure runtime
Statistical Q&A / summary table or chart choiceCode-supported
'What's the average salary by department?' returns a summary table or bar chart, your choice
Claimed on Devpostmedium confidencebackend/workflows/nodes/intent_classifier.py:45— ANALYZE intent classifies statistics/aggregation questions and routes them, but no dedicated code path confirms a user-selectable table-vs-chart output mode beyond general code generationbackend/workflows/nodes/code_generator.py— Likely generates pandas aggregation code for ANALYZE intent, not fully inspected line-by-line
Summarize key findings / human-readable reportCode-supported
'Summarize the key findings from this data' creates a concise, human-readable report
Claimed on Devpostmedium confidencebackend/workflows/nodes/response_generator.py:13— Generates a narrative explanation of executed code's print output via the LLM, which is a report-like text, but there is no distinct 'summarize findings' code path separate from general narrative generation
Advanced/predictive analytics (forecasting)Claimed only
What's next: moving beyond descriptive statistics to include predictive modeling (e.g. forecasting)
Claimed on Devposthigh confidenceAnalysis history (track/revert/branch steps)Claimed only
What's next: 'Analysis History' feature to track, revert, and branch analysis steps like Git for data analysis
Claimed on Devposthigh confidenceSQL database connectionsClaimed only
What's next: plan to add support for connecting directly to SQL databases, Google Sheets, and other live APIs
Claimed on Devposthigh confidence
An AI agent derived these features from the project’s Devpost page and readme, then searched the code for each one. Verified features are backed by cited code; claimed-only features had no supporting code, which is not by itself proof a feature is missing.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.