Spaces:
Sleeping
Sleeping
| title: EDAONSTERIOD | |
| emoji: 👀 | |
| colorFrom: green | |
| colorTo: indigo | |
| sdk: gradio | |
| sdk_version: 5.34.1 | |
| app_file: app.py | |
| pinned: false | |
| short_description: Analytic | |
| # 🔥 Odyssey: The AI Data Science Workspace | |
| 🚀 CognitiveEDA: The Adaptive Intelligence Engine | |
|  | |
|  | |
|  | |
| CognitiveEDA is not just another EDA tool; it's a world-class data discovery platform that intelligently adapts to your data. | |
| This enterprise-grade application goes beyond static profiling by automatically detecting the nature of your dataset (e.g., time-series, text-heavy) and unlocking specialized analysis modules on the fly. Powered by Google's Gemini LLM, it delivers a rich, context-aware, and deeply insightful user experience that transforms raw data into a clear narrative with actionable recommendations. | |
| (A GIF showcasing the adaptive UI revealing specialized tabs after data upload) | |
| ✨ Key Features: The "Wow" Factor | |
| CognitiveEDA is designed to impress data professionals by providing intelligent, context-aware analysis that feels magical. | |
| 🧠 Adaptive Analysis Modules: The UI isn't static. It intelligently detects your data's characteristics and dynamically reveals specialized tabs: | |
| ⌛ Time-Series Analysis: Automatically appears if date/time columns are found. Perform decomposition, check for stationarity (ADF Test), and visualize trends. | |
| 📝 Text Analysis: Unlocks if long-form text columns are present. Instantly generate word clouds to visualize high-frequency terms. | |
| 🧩 Clustering (K-Means): Becomes available for datasets with strong numeric features, allowing you to discover latent groups and customer segments. | |
| 🤖 Hyper-Contextual AI Narrative: The integrated Gemini AI doesn't give a generic report. It receives context about the type of data it's analyzing, leading to far more specific and valuable insights (e.g., suggesting ARIMA for time-series or sentiment analysis for text). | |
| ** Universal Data Ingestion:** Don't be limited to CSV. CognitiveEDA handles CSV and Excel files seamlessly. | |
| ⚡ Performance-Aware: For massive datasets, the tool automatically samples the data for UI interactions to ensure a fast, responsive experience, while still using the full dataset for backend calculations where feasible. | |
| 📊 Comprehensive Core EDA: All the essentials, done better: | |
| Detailed Data Profiling (Missing values, numeric stats, categorical stats). | |
| At-a-glance overview visuals (Data types, missing data heatmap, correlation matrix). | |
| Interactive deep-dive tools for exploring individual features. | |
| 🛠️ Tech Stack | |
| This project leverages a modern, powerful stack for data science and web applications: | |
| Backend & Data Analysis: Python, Pandas, NumPy, scikit-learn, statsmodels | |
| Web Framework & UI: Gradio | |
| AI Integration: Google Generative AI (Gemini) | |
| Visualization: Plotly, Matplotlib, WordCloud | |
| 🚀 Getting Started | |
| You can get your own instance of CognitiveEDA running in just two steps. | |
| 1. Prerequisites | |
| Python 3.9 or higher. | |
| A Google Gemini API Key. You can get a free key from Google AI Studio. | |
| 2. Installation & Launch | |
| First, clone the repository to your local machine: | |
| Generated bash | |
| git clone https://github.com/your-repo/CognitiveEDA.git | |
| cd CognitiveEDA | |
| Use code with caution. | |
| Bash | |
| Next, install all the required dependencies using the requirements.txt file. It's highly recommended to do this within a Python virtual environment. | |
| Generated bash | |
| # Create and activate a virtual environment (optional but recommended) | |
| python -m venv venv | |
| source venv/bin/activate # On Windows, use `venv\Scripts\activate` | |
| # Install all dependencies | |
| pip install -r requirements.txt | |
| Use code with caution. | |
| Bash | |
| Finally, run the application: | |
| Generated bash | |
| python app.py | |
| Use code with caution. | |
| Bash | |
| The application will start and provide a local URL (e.g., http://127.0.0.1:7860) that you can open in your web browser. | |
| 📖 How to Use | |
| Launch the application and open the URL in your browser. | |
| Upload your data file using the "Upload Data File" component. Supported formats are .csv, .xlsx, and .xls. | |
| Enter your Google Gemini API Key in the provided text field. | |
| Click "Build My Dashboard". | |
| Explore! The application will process your data and build a custom dashboard. The standard tabs (AI Narrative, Profile, Overview) will be populated, and any relevant specialized tabs (Time-Series, Text, Clustering) will automatically appear. | |
| Interact with the dropdowns and sliders in each tab to perform deep-dive analyses. | |
| 💡 Future Roadmap & Contributions | |
| CognitiveEDA is an evolving platform. We welcome contributions from the community! | |
| Potential Future Enhancements: | |
| Geospatial Analysis Module: Automatically detect latitude/longitude or location names and generate map-based visualizations. | |
| Interactive HTML Report Export: Export a single, beautiful, and fully interactive HTML file with embedded Plotly charts. | |
| Database Connectors: Allow users to connect directly to PostgreSQL, MySQL, or BigQuery. | |
| Background Job Processing: For extremely large datasets, allow full analysis to run as a background task with progress updates. | |
| Advanced Caching: Implement more sophisticated caching to speed up re-analysis of the same data. | |
| How to Contribute | |
| Fork the repository. | |
| Create a new branch for your feature (git checkout -b feature/AmazingNewFeature). | |
| Commit your changes (git commit -m 'Add some AmazingNewFeature'). | |
| Push to the branch (git push origin feature/AmazingNewFeature). | |
| Open a Pull Request. | |
| 📄 License | |
| This project is licensed under the MIT License - see the LICENSE file for details. |