awesome-llm-apps/ai_agent_tutorials/ai_data_analysis_agent/README.md

AI Data Analysis Agent 🤖📊

An AI data analysis Agent built using the phidata Agent framework and openai's gpt-4o model. This agent helps users analyze their data - csv, excel files through natural language queries, powered by OpenAI's language models and DuckDB for efficient data processing - making data analysis accessible to users regardless of their SQL expertise.

Demo

https://github.com/user-attachments/assets/c6e3a9db-9fea-4610-b0e3-3360ec825d0a

Features

• 📤 File Upload Support:

  • Upload CSV and Excel files
  • Automatic data type detection and schema inference
  • Support for multiple file formats

• 💬 Natural Language Queries:

  • Convert natural language questions into SQL queries
  • Get instant answers about your data
  • No SQL knowledge required

• 🔍 Advanced Analysis:

  • Perform complex data aggregations
  • Filter and sort data
  • Generate statistical summaries
  • Create data visualizations

• 🎯 Interactive UI:

  • User-friendly Streamlit interface
  • Real-time query processing
  • Clear result presentation

How to Run

1. Setup Environment

   # Clone the repository
   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd ai_agent_tutorials/ai_data_analysis_agent
   
   # Install dependencies
   pip install -r requirements.txt
   

2. Configure API Keys

   • Get OpenAI API key from OpenAI Platform

3. Run the Application

   streamlit run ai_data_analyst.py
   

Usage

1. Launch the application using the command above
2. Provide your OpenAI API key in the sidebar of Streamlit
3. Upload your CSV or Excel file through the Streamlit interface
4. Ask questions about your data in natural language
5. View the results and generated visualizations