Update README.md

README.md

@@ -9,28 +9,115 @@ app_file: app.py
 pinned: false
 ---
 
-# 🚀 BizIntel AI Ultra
+# 📊 BizIntel AI Ultra – Advanced Analytics & Agentic BI
 
-**Next-gen Business Analytics App powered by Google ADK, Gemini Pro, and Streamlit**
+**BizIntel AI Ultra** turns any data table—whether a quick CSV upload or a live
+database table—into an interactive **insight & forecasting workspace** powered
+by:
 
-...
+* **Google Gemini 1.5 Pro** ⇒ natural-language strategy briefs  
+* **ARIMA time-series pipeline** ⇒ 90-step (or 3-period) forecasts with
+  model explainability, back-testing, residual ACF & CI bands  
+* **Plotly Dark™** trend, forecast & EDA visuals  
+* **Streamlit** front-end running inside a Hugging Face Space  
+* **Modular tools** (`csv_parser`, `plot_generator`, `forecaster`,
+  `visuals`, `db_connector`) for quick reuse in your own projects
 
+---
+
+## 🚀 Live Demo (Hugging Face Space)
+
+<https://huggingface.co/spaces/your-handle/BizIntel_AI>
+
+Upload a CSV or Excel (≤ 500 MB) **or** connect to PostgreSQL / MySQL /
+SQL Server / Oracle via a SQLAlchemy URI, select a date column and a numeric
+metric, and watch:
+
+1. Trend chart   
+2. 90-step forecast with confidence fan, summary stats & interpret-ability  
+3. Gemini-generated strategy report  
+4. Optional histograms, scatter matrices, correlation heat-maps
+
+---
+
+## ✨ Features
+
+| Area | Details |
+| ---- | ------- |
+| **Data ingest** | CSV, XLS/XLSX, or DB fetch (`sqlalchemy` URI) |
+| **Sampling** | Auto-samples giant CSVs (≥ 1 M rows) to avoid OOM |
+| **Quick scan** | Markdown dataset overview: schema, missing %, numeric `describe()` |
+| **Trend** | Interactive line + markers (Plotly Dark) |
+| **Forecast** | ARIMA(1,1,1) auto-freq, 90-step (daily) or 3-step (monthly, etc) |
+| | CI fan, residual ACF plot, 20 % back-test (MAPE, RMSE) |
+| | Seasonal decomposition (toggle) |
+| **Explainability** | Model summary table, plain-English coef notes |
+| **Gemini 1.5 Pro** | 5 insights, 3 strategies, risks, extra-visuals → Markdown + download |
+| **EDA** | Histograms (with KDE), box / violin plots, scatter-matrix, corr heat-map |
+| **Static images** | All figures also saved to `/tmp/*.png` for downstream reports |
+| **Extensible** | Each visual is a standalone helper in `tools/` |
+
+---
+
+## 🛠 Local Dev Setup
+
+```bash
+# 1. Clone
+git clone https://github.com/your-handle/BizIntel_AI.git
+cd BizIntel_AI
+
+# 2. Python env
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+
+# 3. Gemini key
+export GEMINI_APIKEY="your_google_ai_studio_key"
+
+# 4. Run
+streamlit run app.py
+Note : ARIMA & seasonal decomposition come from
+statsmodels; Plotly PNG export needs kaleido.
+These are included in requirements.txt.
+
+🔌 Database Connect String Examples
+text
+Copy code
+# PostgreSQL
+postgresql+psycopg2://user:password@host:port/dbname
+
+# MySQL
+mysql+pymysql://user:password@host/dbname
 
+# SQL Server
+mssql+pyodbc://user:password@host:1433/db?driver=ODBC+Driver+17+for+SQL+Server
 
+# Oracle
+oracle+cx_oracle://user:password@host:1521/?service_name=ORCL
+🌐 Deploying to Hugging Face Spaces
+Space ▸ Create ▸ Docker template
 
-# 🚀 BizIntel AI Ultra
+Push repo (Dockerfile, app.py, tools/, requirements.txt)
 
-**Next-gen Business Analytics App powered by Google ADK, Gemini Pro, and Streamlit**
+Add a secret → GEMINI_APIKEY
 
-## Features
-- Upload CSV or connect to databases (PostgreSQL, MySQL, MSSQL, Oracle, SQLite)
-- ADK multi-agent orchestration: trend analysis, forecasting, strategic insights
-- Interactive Streamlit dashboard with visual charts
-- Hugging Face Spaces Docker-based deployment
+Space builds ; enjoy!
 
-## Usage
-1. Select your data source: file upload or SQL DB connection
-2. Run agent analysis pipeline
-3. View KPIs, charts, forecasts, and strategy
+🗺 Project Structure
+Copy code
+├─ app.py
+├─ requirements.txt
+├─ Dockerfile
+├─ tools/
+│   ├─ csv_parser.py
+│   ├─ plot_generator.py
+│   ├─ forecaster.py
+│   ├─ visuals.py
+│   └─ db_connector.py
+└─ README.md
+🤝 Contributing
+Issues & PRs are welcome!
+Please run black -l 88 and ruff before submitting.
 
-Built with ❤️ using Streamlit + Gemini + ADK
+📜 License
+MIT © 2025 BizIntel AI Ultra Team