README.md

---
title: ChaRtBot
emoji: 📊
sdk: docker
app_file: app.py
pinned: true
---

# ChaRtBot 📊

**AI-assisted data visualization through natural language prompts**

ChaRtBot is a web application that transforms natural language descriptions into interactive data visualizations using Plotly. Simply upload your CSV file, describe what you want to see, and let AI generate the visualization code for you.

## What is ChaRtBot?

ChaRtBot leverages large language models (LLMs) to generate Python code for creating data visualizations based on user prompts. It bridges the gap between data analysis intent and implementation, making it easier for users to explore and visualize their data without writing code from scratch.

### Key Features

- **Natural Language Interface**: Describe your visualization needs in plain English
- **CSV Data Upload**: Upload your own datasets for instant analysis
- **AI-Powered Code Generation**: Automatically generates Plotly visualization code
- **Interactive Visualizations**: All charts are fully interactive using Plotly
- **Gallery of Examples**: Browse pre-made visualizations for inspiration
- **Code Review**: View and download the generated Python code
- **Export Options**: Download visualizations as HTML or static images

## How It Works

1. **Upload Data**: Choose a CSV file containing your dataset
2. **Write Prompt**: Describe your visualization using natural language (e.g., "Create a heatmap of weekly sales by month")
3. **Generate**: AI analyzes your data and prompt, then generates appropriate Plotly code
4. **Review**: Examine the generated visualization and code
5. **Export**: Download as interactive HTML or static image

## Technology Stack

- **Frontend**: Dash with Dash Mantine Components
- **Visualization**: Plotly
- **AI Model**: Llama 3.3 70B via Groq API (LangChain)
- **Data Processing**: Pandas, NumPy
- **Deployment**: Docker-ready