How codergirl-cyber/tablyze works
Tablyze is a CSV-analysis web application. Users upload a dataset, receive statistical and visualization results, and can ask an AI agent questions grounded in analysis tools; reports can also be exported. The README documents the overall analysis and AI workflow, while excerpts and the source index support the main module relationships. The API route implementations and some frontend request wiring were not excerpted, so those links are left unverified rather than asserted.
Main entry points: page.tsx Dashboard page · main.py FastAPI service · FileCard.tsx Upload controls · route.ts Investigation route
Components 22
Dashboard
- Dashboard page
app/page.tsx - Upload controls
app/components/FileCard.tsx - Upload progress
app/components/UploadProgress.tsx - Summary cards
app/components/StatCard.tsx - Missing values chart
app/components/MissingValuesBarChart.tsx - Data types chart
app/components/DataTypesPieChart.tsx - Correlation heatmap
app/components/CorrelationHeatmap.tsx - PDF report export
app/components/ExportReportButton.tsx - Question interface
app/components/DataAgentSection.tsx - Investigation client
app/lib/agent.ts
Web API
- Upload route
app/api/upload/route.ts - Investigation route
app/api/agent/investigate/route.ts - FastAPI service
backend/main.py
Dataset Analysis
- Analysis cache
backend/cache.py - Dataset state
backend/agent/state.py - Dataset statistics
backend/analysis.py
AI Investigation
- Investigation planner
backend/agent/agent.py - Analysis tools
backend/agent/tools.py - LLM provider client
backend/agent/llm_client.py - Provider interface
backend/agent/llm.py
Other components
- Dataset user
- LLM provider service
Connections 24
- Dataset user → Dashboard page: uses
README.md - Dashboard page → Upload controls: renders
app/page.tsx - Dashboard page → Summary cards: renders
app/page.tsx - Dashboard page → Missing values chart: renders
app/page.tsx - Dashboard page → Data types chart: renders
app/page.tsx - Dashboard page → Correlation heatmap: renders
app/page.tsx - Dashboard page → PDF report export: renders
app/page.tsx - Upload controls → Upload progress: renders
app/components/FileCard.tsx - Upload controls → Upload route: submits CSV
- Upload route → FastAPI service: forwards upload
- FastAPI service → Analysis cache: checks cache
backend/main.py - FastAPI service → Dataset statistics: analyzes dataset
backend/main.py - FastAPI service → Dataset state: stores dataset
backend/main.py - FastAPI service → Investigation route: serves investigation
- Dashboard page → Question interface: renders
app/page.tsx - Question interface → Investigation client: requests answer
app/components/DataAgentSection.tsx - Investigation client → Investigation route: posts question
app/lib/agent.ts - Investigation route → FastAPI service: routes question
- Investigation planner → Analysis tools: dispatches tools
backend/agent/agent.py - Analysis tools → Dataset statistics: uses analysis
backend/agent/tools.py - Investigation planner → LLM provider client: requests synthesis
backend/agent/agent.py - Provider interface → LLM provider client: delegates calls
backend/agent/llm.py - LLM provider client → LLM provider service: sends prompts
backend/agent/llm_client.py - Dashboard page → PDF report export: exports report
app/components/ExportReportButton.tsx