README.md

metadata

title: AI Data Analyst Chatbot
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: src/question-answer/app.py
pinned: false
license: mit
short_description: AI chatbot that analyzes your data

🤖 AI Data Analyst Chatbot

An intelligent AI-powered chatbot that transforms your data analysis workflow. Upload any dataset and have natural conversations about your data, getting instant insights, visualizations, and comprehensive reports.

✨ Features

• 🗣️ Natural Conversation: Chat naturally with your AI analyst - ask questions, get clarifications, or just have a friendly conversation
• 📊 Smart Analysis: Intelligent decision-making that only runs full analysis when needed
• 📈 Rich Visualizations: Interactive charts and graphs that you can zoom and explore
• 📝 Comprehensive Reports: Detailed analysis reports with code, execution results, and insights
• 🎯 Suggested Questions: Get intelligent suggestions based on your dataset structure
• 💾 Persistent Context: Upload once, analyze multiple times with full conversation memory

🚀 How to Use

1. Upload Your Dataset: Support for CSV, Excel, JSON, and Parquet files
2. Start Chatting: Ask questions naturally or use the suggested questions
3. Get Insights: Receive analysis, visualizations, and reports directly in the chat
4. Continue Exploring: Ask follow-up questions and dive deeper into your data

💡 Example Questions

• "What are the main trends in this dataset?"
• "Show me the distribution of sales by region"
• "What are the top 5 products by revenue?"
• "Can you create a correlation matrix?"
• "What insights can you find about customer behavior?"

🛠️ Technical Details

• Framework: Gradio + LangGraph
• AI Models: GPT-4o-mini for decision making and responses
• Analysis Pipeline: Multi-agent system with code generation, execution, and visualization
• Deployment: Ready for Hugging Face Spaces

📋 Supported File Types

• CSV files (.csv)
• Excel files (.xlsx, .xls)
• JSON files (.json)
• Parquet files (.parquet)

🔧 Installation

pip install -r requirements.txt
python src/question-answer/app.py

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Ready to analyze your data? Upload a dataset and start chatting with your AI analyst! 🚀