Skip to content

kanish818/AutoAnalyst-Agent

Repository files navigation

⚑ AutoAnalyst Agent β€” Your AI-Powered Data Companion

Smarter, faster, and more intuitive analysis of your datasets using Generative AI + Python magic.
Repository: Insert your GitHub repo link here


πŸ“Œ What Is This?

Meet AutoAnalyst Agent 2.0 β€” an AI-driven assistant that eliminates tedious data crunching.
Upload your dataset + queries, and instantly get:
βœ… Visual reports
βœ… AI-generated insights
βœ… Automated workflows

Perfect for:

  • Analysts 🧾
  • Researchers πŸ”¬
  • Startups & Businesses πŸ“ˆ
  • Anyone who loves turning raw data into knowledge

✨ Key Highlights

Feature Why It’s Awesome πŸš€
πŸ€– AI-Powered Insights Uses Google’s Generative AI to β€œunderstand” your data
πŸ“Š Rich Visualizations Generates plots with Seaborn & Matplotlib
🌍 Web Scraper Mode Fetch live data directly from URLs
πŸ“‚ Multi-Format Friendly Accepts CSV, Excel, JSON, Parquet, or TXT
πŸ”„ Ask Many at Once Batch processing for multiple questions
πŸ–₯️ Simple-to-Use Interface Beginner friendly, no steep learning curve
⚑ Super-Fast Execution Optimized for speed + real-time feedback

πŸš€ Getting Started

1️⃣ Clone the Repo - git clone https://github.com/kanish818/AutoAnalyst-Agent.git

cd autoanalyst-agent

2️⃣ Install Requirements - pip install -r requirements.txt

3️⃣ Configure API Keys

Create a .env file inside the root folder:
GROQ_API_KEY=your_groq_api_key GROQ_MODEL=llama-3.3-70b-versatile LLM_TIMEOUT_SECONDS=240

4️⃣ Start the Application - uvicorn app:app --host 0.0.0.0 --port 8000 --reload

Now open http://localhost:8000/ in your browser 🌐

πŸ§‘β€πŸ’» How It Works

  1. Write Your Questions
    Create a .txt file with queries like: What’s the revenue growth month-over-month?, Find correlation between Age and Income, Show most profitable products...etc

  2. Upload Dataset + Questions File

  • Dataset (optional) β†’ CSV, Excel, JSON, Parquet, or TXT
  • Questions file (required) β†’ Plain text
  1. VoilΓ !
  • AI processes the queries
  • Generates insights + summaries
  • Builds neat visualizations

πŸ›  Tech Behind the Scenes

Backend

  • FastAPI ⚑ β†’ High-performance web server
  • LangChain 🧠 β†’ Orchestrates LLM interactions
  • Google Generative AI ✨ β†’ Core AI engine
  • Pandas + NumPy πŸ“Š β†’ Data wrangling made smooth
  • Seaborn + Matplotlib 🎨 β†’ Clean, insightful charts

Frontend

  • HTML5 + CSS + JavaScript
  • Bootstrap-inspired modern UI

πŸ”§ API Blueprint

Method Endpoint Purpose
GET / Access web app
POST /api Submit dataset + questions
GET /summary App diagnostics & summaries

πŸ“‚ File Support

Format Extensions
CSV .csv
Excel .xlsx, .xls
JSON .json
Parquet .parquet
Text .txt

🎯 Where Can You Use This?

  • πŸ“ˆ Business Strategy – Sales, KPIs, forecasts
  • πŸ”¬ Research – Data exploration, hypothesis validation
  • πŸ€– Data Science – Quick EDA, anomaly detection
  • πŸ“Š Reporting – Automated dashboards

πŸ”’ Security First

  • βœ… No cloud storage β†’ All data stays local
  • βœ… API keys kept safe via .env
  • βœ… Configurable CORS policy for production use

πŸ“œ License

Licensed under MIT – free for personal & commercial use.

About

Meet AutoAnalyst Agent 2.0 β€” an AI-driven assistant that eliminates tedious data crunching. Upload your dataset + queries, and instantly get: βœ… Visual reports βœ… AI-generated insights βœ… Automated workflows Perfect for: Analysts 🧾 Researchers πŸ”¬ Startups & Businesses πŸ“ˆ Anyone who loves turning raw data into knowledge

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages