Spaces:
Sleeping
Sleeping
| license: mit | |
| title: A simple Data Analyzer | |
| sdk: gradio | |
| emoji: 📊 | |
| colorFrom: red | |
| pinned: true | |
| thumbnail: >- | |
| https://cdn-uploads.huggingface.co/production/uploads/69848113135d8332da94b363/JFpif40IVp5pJhMZ0-n8x.png | |
| # Personal Data Assistant | |
| A simple interactive data analysis and visualization assistant built with Python and Gradio. Ask questions about your datasets, generate insightful visualizations, and get instant answers—all in a beautiful, user-friendly web interface. | |
| ![Gradio App Screenshot] (images/image.png) | |
| ## Features | |
| - **Conversational Data Analysis**: Chat with the agent to analyze your CSV datasets. | |
| - **Automatic Visualizations**: Instantly generate bar charts and other graphs from your data. | |
| - **Modern UI**: Custom black and red theme for a sleek, professional look. | |
| - **Conversation Logging**: Keeps a log of your questions and the agent's responses. | |
| - **Easy Dataset Upload**: Upload your own CSV files for instant analysis. | |
| ## Demo | |
| https://your-demo-link.com | |
| ## Getting Started | |
| ### Prerequisites | |
| - Python 3.10+ | |
| - pip (Python package manager) | |
| ### Installation | |
| 1. **Clone the repository:** | |
| ```bash | |
| git clone https://github.com/yourusername/personal-data-assistant.git | |
| cd personal-data-assistant | |
| ``` | |
| 2. **Create a virtual environment (optional but recommended):** | |
| ```bash | |
| python -m venv venv | |
| source venv/bin/activate # On Windows: venv\Scripts\activate | |
| ``` | |
| 3. **Install dependencies:** | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 4. **Set up environment variables:** | |
| - Create a `.env` file in the project root with your API keys for the model: | |
| ```env | |
| MISTRAL_API_KEY=your_mistral_api_key | |
| ``` | |
| ### Running the App | |
| ```bash | |
| python app.py | |
| ``` | |
| The Gradio interface will launch in your browser. | |
| ## Usage | |
| - **Ask questions** about your dataset in natural language. | |
| - **Upload a CSV file** to analyze your own data. | |
| - **View generated graphs** and download them if needed. | |
| ## Example Datasets | |
| - `housing_dataset.csv`: Sample housing prices by city. | |
| ## Project Structure | |
| ``` | |
| ├── app.py # Gradio web app | |
| ├── main.py # Core agent logic and tools | |
| ├── housing_dataset.csv # Example dataset | |
| ├── vgsales.csv # Example dataset | |
| ├── conversation_log.txt # Conversation history | |
| ├── .gitignore | |
| └── .gradio/flagged/ # Gradio flagged data | |
| ``` | |
| ## Technologies Used | |
| - Python | |
| - Gradio | |
| - Matplotlib, Seaborn, Pandas | |
| - smolagents, LiteLLM | |
| ## Customization | |
| - Modify `custom_css` in `app.py` to change the UI theme. | |
| - Add new tools or models in `main.py`. | |
| ## License | |
| MIT License. See [LICENSE](LICENSE) for details. | |
| ## Acknowledgements | |
| - [Gradio](https://gradio.app/) | |
| - [Mistral AI](https://mistral.ai/) | |
| - [smol-ai/smolagents](https://github.com/smol-ai/smolagents) | |
| --- | |
| *Made with ❤️ for data enthusiasts.* |