README.md

metadata

title: LLM Excel Plotter
emoji: 📊
colorFrom: indigo
colorTo: purple
sdk: docker
sdk_version: '1.0'
app_file: app.py
app_port: 7860
pinned: false

LLM Excel Plotter Agent

An intelligent Hugging Face Space that uses Large Language Models to process Excel data, generate meaningful charts, and provide automated analysis.

Features

• 📈 Intelligent Chart Generation: Uses Qwen2.5 and BART models to understand data and generate appropriate visualizations
• 🤖 LLM-Powered Analysis: Leverages state-of-the-art language models for data interpretation
• 📊 Multiple Chart Types: Supports line charts, bar charts, scatter plots, and more
• 🎨 Interactive UI: Clean, modern interface built with React and Plotly.js
• 📁 File Upload: Process CSV files and get instant analysis

Models & APIs

Local Models (Free)

• Qwen2.5-1.5B-Instruct: Local inference for data analysis
• BART Fine-tuned: Custom model for structured text generation

Supported External APIs (Optional)

• Gemini 2.0 Flash: Add GEMINI_API_KEY environment variable
• Grok-3 Mini: Add GROK_API_KEY environment variable

Usage

1. Upload a CSV file containing your data
2. Ask the chatbot to analyze or visualize specific aspects
3. View generated charts and insights
4. Export results or ask follow-up questions

Deployment

Built with:

• Backend: Flask (Python 3.10)
• Frontend: React 18.3.1
• LLM Integration: Transformers, HuggingFace Inference
• Data Processing: Pandas, Scikit-learn

Deploy to Hugging Face Spaces with Docker support enabled.

Health And Wake-Up Endpoint

To support cold-start recovery on free-tier Hugging Face Spaces, this backend exposes:

• GET /health

This endpoint is lightweight and intended for:

• frontend wake-up checks before user requests,
• retry logic diagnostics,
• optional cron-based warm-up pings.

Example:

curl https://<your-space>.hf.space/health

Typical response:

{
    "status": "ok",
    "service": "llm-excel-plotter-agent",
    "uptime_seconds": 12.34,
    "timestamp": 1700000000
}

---

For more information, visit the project repository