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.
- Prerequisites Python 3.9 or higher. A Google Gemini API Key. You can get a free key from Google AI Studio.
- 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.