Metadata-Version: 2.4
Name: agentic-dashboard-ai
Version: 0.1.1
Summary: Autonomous BI dashboard agent for plug-and-play analytics and Power BI integration
Home-page: https://github.com/idrissbado/agentic-ai
Author: Idriss Bado
Author-email: Idriss Bado <your.email@example.com>
License: MIT License
        
        Copyright (c) 2026 Idriss Bado
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: requests
Requires-Dist: openpyxl
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Agentic Autonomous BI

![Agentic BI](https://img.shields.io/badge/AI-Autonomous%20BI-blue?style=for-the-badge)
![Power BI](https://img.shields.io/badge/Power%20BI-API-yellow?style=for-the-badge)
![Python](https://img.shields.io/badge/Python-3.9%2B-green?style=for-the-badge)
![Plug&Play](https://img.shields.io/badge/Plug%20%26%20Play-Configurable-brightgreen?style=for-the-badge)

---

## 🚀 Agentic Autonomous BI

The most advanced, fully autonomous, multi-platform BI agent: create, analyze, and publish your Power BI, Looker, Metabase, Next.js dashboards… with zero human intervention.

- **Multi-agent orchestration**: Planner, Data, Analytics, QA, Viz, Power BI, Integration
- **Plug & Play**: configure everything in `config.yaml`, launch, and you’re ready
- **Multi-source**: Excel, CSV, SQL, ERP, BigQuery, etc.
- **Full automation**: extraction, analysis, QA, BI publishing
- **Extensible**: add your own connectors, APIs, modules

---

## 📦 Installation

```bash
pip install agentic-autonomous-bi
```

## 🛠️ Configuration

1. Clone the repo
2. Edit `config.yaml` (Azure credentials, data source, integrations)
3. Install dependencies
   ```bash
   pip install -r requirements.txt
   ```
4. Launch the agent
   ```bash
   python orchestrator/orchestrator.py
   ```

---

## 🌐 BI Integrations

- **Power BI**: REST API, create datasets, dashboards, reports
- **Looker Studio**: CSV/Excel export, Google Drive/Sheets publishing
- **Metabase**: CSV/Excel export, watched folder/API publishing
- **Next.js/React**: JSON export, public folder publishing

---

## 🧠 Architecture

```
User
 ↓
Agentic BI Orchestrator (LangGraph / CrewAI)
 ↓
 ┌───────────────────────────────────┐
 │ Planner Agent                      │
 │ Data Agent (SQL, DAX)               │
 │ Analytics Agent (KPIs, trends)      │
 │ Visualization Agent (PowerBI JSON) │
 │ QA Agent (Data quality & sanity)    │
 │ PowerBI Agent (REST API calls)      │
 │ Integration Agent (auto-publish)    │
 └───────────────────────────────────┘
```

---

## ✨ Features

- Multi-agent orchestration
- Multi-source extraction and analysis
- QA and data quality control
- Power BI, Looker, Metabase, Next.js dashboard generation
- Automated publishing
- Single YAML configuration
- Extensible and modular

---

## 🔒 Security
- Azure Service Principal authentication
- Secure credential management

---

## 🧪 Quick Test

```bash
python orchestrator/orchestrator.py
```

---

## 📖 Documentation

- [Install Guide](https://github.com/idrissbado/agentic-ai/blob/master/DEPLOY_AUTONOMOUS_BI.md)
- [Power BI Integration](https://github.com/idrissbado/agentic-ai/blob/master/INTEGRATION_BI.md)
- [React/Next.js Integration](https://github.com/idrissbado/agentic-ai/blob/master/INTEGRATION_REACT_NEXTJS.md)
- [Metabase Integration](https://github.com/idrissbado/agentic-ai/blob/master/INTEGRATION_METABASE.md)
- [Looker Integration](https://github.com/idrissbado/agentic-ai/blob/master/INTEGRATION_LOOKER.md)

**Note:** PyPI only displays this README. Documentation files (like integration guides) are not directly served by PyPI. All documentation links above point to GitHub and will always work. If you click a link that starts with `https://pypi.org/...`, it will result in a 404 error. Always use the GitHub links in this README for full documentation.

---

## 👤 Author
**Idriss Bado**  
[GitHub](https://github.com/idrissbado)

---

## ⭐️ Contribute
Pull requests, issues, and suggestions welcome!

---

## 🏆 License
MIT License

---

## 📁 Project Structure

- `powerbi/` : Power BI authentication and API integration
- `orchestrator/` : Main orchestration logic
- `data/` : Data sources and connectors
- `dashboards/` : Exported dashboards and visualizations
- `agents/` : Modular agents (Planner, Data, Analytics, QA, Visualization, Integration)
- `config.yaml` : Central configuration file
- `requirements.txt` : Python dependencies
- `README.md` : Project documentation

---

## 🧩 Extending

- Add SQL, ERP, BigQuery connectors in `agents/data_agent.py`
- Add new Power BI API methods in `powerbi/api.py`
- Add advanced analytics in `agents/analytics_agent.py`

---

## 💬 Contact & Support

For questions, issues, or contributions, please open an issue or pull request on GitHub, or contact the author via the profile link above.
