Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -11,6 +11,7 @@ short_description: Analytic
|
|
| 11 |
---
|
| 12 |
# π₯ Odyssey: The AI Data Science Workspace
|
| 13 |
|
|
|
|
| 14 |
π CognitiveEDA: The Adaptive Intelligence Engine
|
| 15 |

|
| 16 |
|
|
@@ -20,25 +21,36 @@ short_description: Analytic
|
|
| 20 |
CognitiveEDA is not just another EDA tool; it's a world-class data discovery platform that intelligently adapts to your data.
|
| 21 |
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.
|
| 22 |
(A GIF showcasing the adaptive UI revealing specialized tabs after data upload)
|
|
|
|
| 23 |
β¨ Key Features: The "Wow" Factor
|
|
|
|
| 24 |
CognitiveEDA is designed to impress data professionals by providing intelligent, context-aware analysis that feels magical.
|
|
|
|
| 25 |
π§ Adaptive Analysis Modules: The UI isn't static. It intelligently detects your data's characteristics and dynamically reveals specialized tabs:
|
|
|
|
| 26 |
β Time-Series Analysis: Automatically appears if date/time columns are found. Perform decomposition, check for stationarity (ADF Test), and visualize trends.
|
|
|
|
| 27 |
π Text Analysis: Unlocks if long-form text columns are present. Instantly generate word clouds to visualize high-frequency terms.
|
|
|
|
| 28 |
π§© Clustering (K-Means): Becomes available for datasets with strong numeric features, allowing you to discover latent groups and customer segments.
|
|
|
|
| 29 |
π€ 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).
|
| 30 |
** Universal Data Ingestion:** Don't be limited to CSV. CognitiveEDA handles CSV and Excel files seamlessly.
|
|
|
|
| 31 |
β‘ 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.
|
| 32 |
π Comprehensive Core EDA: All the essentials, done better:
|
|
|
|
| 33 |
Detailed Data Profiling (Missing values, numeric stats, categorical stats).
|
| 34 |
At-a-glance overview visuals (Data types, missing data heatmap, correlation matrix).
|
| 35 |
Interactive deep-dive tools for exploring individual features.
|
|
|
|
| 36 |
π οΈ Tech Stack
|
| 37 |
This project leverages a modern, powerful stack for data science and web applications:
|
| 38 |
Backend & Data Analysis: Python, Pandas, NumPy, scikit-learn, statsmodels
|
| 39 |
Web Framework & UI: Gradio
|
| 40 |
AI Integration: Google Generative AI (Gemini)
|
| 41 |
Visualization: Plotly, Matplotlib, WordCloud
|
|
|
|
| 42 |
π Getting Started
|
| 43 |
You can get your own instance of CognitiveEDA running in just two steps.
|
| 44 |
1. Prerequisites
|
|
@@ -48,11 +60,13 @@ A Google Gemini API Key. You can get a free key from Google AI Studio.
|
|
| 48 |
First, clone the repository to your local machine:
|
| 49 |
Generated bash
|
| 50 |
git clone https://github.com/your-repo/CognitiveEDA.git
|
|
|
|
| 51 |
cd CognitiveEDA
|
| 52 |
Use code with caution.
|
| 53 |
Bash
|
| 54 |
Next, install all the required dependencies using the requirements.txt file. It's highly recommended to do this within a Python virtual environment.
|
| 55 |
Generated bash
|
|
|
|
| 56 |
# Create and activate a virtual environment (optional but recommended)
|
| 57 |
python -m venv venv
|
| 58 |
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
|
|
@@ -67,16 +81,19 @@ python app.py
|
|
| 67 |
Use code with caution.
|
| 68 |
Bash
|
| 69 |
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.
|
|
|
|
| 70 |
π How to Use
|
| 71 |
Launch the application and open the URL in your browser.
|
| 72 |
Upload your data file using the "Upload Data File" component. Supported formats are .csv, .xlsx, and .xls.
|
| 73 |
Enter your Google Gemini API Key in the provided text field.
|
| 74 |
Click "Build My Dashboard".
|
|
|
|
| 75 |
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.
|
| 76 |
Interact with the dropdowns and sliders in each tab to perform deep-dive analyses.
|
| 77 |
π‘ Future Roadmap & Contributions
|
| 78 |
CognitiveEDA is an evolving platform. We welcome contributions from the community!
|
| 79 |
Potential Future Enhancements:
|
|
|
|
| 80 |
Geospatial Analysis Module: Automatically detect latitude/longitude or location names and generate map-based visualizations.
|
| 81 |
Interactive HTML Report Export: Export a single, beautiful, and fully interactive HTML file with embedded Plotly charts.
|
| 82 |
Database Connectors: Allow users to connect directly to PostgreSQL, MySQL, or BigQuery.
|
|
@@ -84,9 +101,11 @@ Background Job Processing: For extremely large datasets, allow full analysis to
|
|
| 84 |
Advanced Caching: Implement more sophisticated caching to speed up re-analysis of the same data.
|
| 85 |
How to Contribute
|
| 86 |
Fork the repository.
|
|
|
|
| 87 |
Create a new branch for your feature (git checkout -b feature/AmazingNewFeature).
|
| 88 |
Commit your changes (git commit -m 'Add some AmazingNewFeature').
|
| 89 |
Push to the branch (git push origin feature/AmazingNewFeature).
|
| 90 |
Open a Pull Request.
|
|
|
|
| 91 |
π License
|
| 92 |
This project is licensed under the MIT License - see the LICENSE file for details.
|
|
|
|
| 11 |
---
|
| 12 |
# π₯ Odyssey: The AI Data Science Workspace
|
| 13 |
|
| 14 |
+
|
| 15 |
π CognitiveEDA: The Adaptive Intelligence Engine
|
| 16 |

|
| 17 |
|
|
|
|
| 21 |
CognitiveEDA is not just another EDA tool; it's a world-class data discovery platform that intelligently adapts to your data.
|
| 22 |
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.
|
| 23 |
(A GIF showcasing the adaptive UI revealing specialized tabs after data upload)
|
| 24 |
+
|
| 25 |
β¨ Key Features: The "Wow" Factor
|
| 26 |
+
|
| 27 |
CognitiveEDA is designed to impress data professionals by providing intelligent, context-aware analysis that feels magical.
|
| 28 |
+
|
| 29 |
π§ Adaptive Analysis Modules: The UI isn't static. It intelligently detects your data's characteristics and dynamically reveals specialized tabs:
|
| 30 |
+
|
| 31 |
β Time-Series Analysis: Automatically appears if date/time columns are found. Perform decomposition, check for stationarity (ADF Test), and visualize trends.
|
| 32 |
+
|
| 33 |
π Text Analysis: Unlocks if long-form text columns are present. Instantly generate word clouds to visualize high-frequency terms.
|
| 34 |
+
|
| 35 |
π§© Clustering (K-Means): Becomes available for datasets with strong numeric features, allowing you to discover latent groups and customer segments.
|
| 36 |
+
|
| 37 |
π€ 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).
|
| 38 |
** Universal Data Ingestion:** Don't be limited to CSV. CognitiveEDA handles CSV and Excel files seamlessly.
|
| 39 |
+
|
| 40 |
β‘ 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.
|
| 41 |
π Comprehensive Core EDA: All the essentials, done better:
|
| 42 |
+
|
| 43 |
Detailed Data Profiling (Missing values, numeric stats, categorical stats).
|
| 44 |
At-a-glance overview visuals (Data types, missing data heatmap, correlation matrix).
|
| 45 |
Interactive deep-dive tools for exploring individual features.
|
| 46 |
+
|
| 47 |
π οΈ Tech Stack
|
| 48 |
This project leverages a modern, powerful stack for data science and web applications:
|
| 49 |
Backend & Data Analysis: Python, Pandas, NumPy, scikit-learn, statsmodels
|
| 50 |
Web Framework & UI: Gradio
|
| 51 |
AI Integration: Google Generative AI (Gemini)
|
| 52 |
Visualization: Plotly, Matplotlib, WordCloud
|
| 53 |
+
|
| 54 |
π Getting Started
|
| 55 |
You can get your own instance of CognitiveEDA running in just two steps.
|
| 56 |
1. Prerequisites
|
|
|
|
| 60 |
First, clone the repository to your local machine:
|
| 61 |
Generated bash
|
| 62 |
git clone https://github.com/your-repo/CognitiveEDA.git
|
| 63 |
+
|
| 64 |
cd CognitiveEDA
|
| 65 |
Use code with caution.
|
| 66 |
Bash
|
| 67 |
Next, install all the required dependencies using the requirements.txt file. It's highly recommended to do this within a Python virtual environment.
|
| 68 |
Generated bash
|
| 69 |
+
|
| 70 |
# Create and activate a virtual environment (optional but recommended)
|
| 71 |
python -m venv venv
|
| 72 |
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
|
|
|
|
| 81 |
Use code with caution.
|
| 82 |
Bash
|
| 83 |
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.
|
| 84 |
+
|
| 85 |
π How to Use
|
| 86 |
Launch the application and open the URL in your browser.
|
| 87 |
Upload your data file using the "Upload Data File" component. Supported formats are .csv, .xlsx, and .xls.
|
| 88 |
Enter your Google Gemini API Key in the provided text field.
|
| 89 |
Click "Build My Dashboard".
|
| 90 |
+
|
| 91 |
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.
|
| 92 |
Interact with the dropdowns and sliders in each tab to perform deep-dive analyses.
|
| 93 |
π‘ Future Roadmap & Contributions
|
| 94 |
CognitiveEDA is an evolving platform. We welcome contributions from the community!
|
| 95 |
Potential Future Enhancements:
|
| 96 |
+
|
| 97 |
Geospatial Analysis Module: Automatically detect latitude/longitude or location names and generate map-based visualizations.
|
| 98 |
Interactive HTML Report Export: Export a single, beautiful, and fully interactive HTML file with embedded Plotly charts.
|
| 99 |
Database Connectors: Allow users to connect directly to PostgreSQL, MySQL, or BigQuery.
|
|
|
|
| 101 |
Advanced Caching: Implement more sophisticated caching to speed up re-analysis of the same data.
|
| 102 |
How to Contribute
|
| 103 |
Fork the repository.
|
| 104 |
+
|
| 105 |
Create a new branch for your feature (git checkout -b feature/AmazingNewFeature).
|
| 106 |
Commit your changes (git commit -m 'Add some AmazingNewFeature').
|
| 107 |
Push to the branch (git push origin feature/AmazingNewFeature).
|
| 108 |
Open a Pull Request.
|
| 109 |
+
|
| 110 |
π License
|
| 111 |
This project is licensed under the MIT License - see the LICENSE file for details.
|