README.md first version

README.md

@@ -6,13 +6,231 @@ colorTo: indigo
 sdk: docker
 short_description: GitRepo Inspector Application Dashboard
 pinned: true
+license: apache-2.0
 tags:
-  - mcp-in-action-track-enterprise  
-  - mcp-client
-  - agents
-  - blaxel
-  - issue-tracker
+  - mcp-in-action-track-enterprise
+  - mcp
   - gradio
+  - smolagents
+  - dashboard
+  - issue-tracker
+  - github
+  - gemini
+---
+
+<p align="center">
+  <img src="https://huggingface.co/datasets/DEVAIEXP/assets/resolve/main/gitrepo_inspector_dashboard_logo.PNG" alt="GitRepo Inspector Logo" width="400"/>
+</p>
+
+# 📊 GitRepo Inspector: Dashboard & AI Assistant
+
+**An interactive dashboard and AI assistant for GitHub issue triage & management**
+
+[![MCP's 1st Birthday Hackathon](https://img.shields.io/badge/MCP%27s%201st%20Birthday-Hackathon-blue)](https://huggingface.co/MCP-1st-Birthday)
+[![Powered by Gradio](https://img.shields.io/badge/Powered%20by-Gradio-orange)](https://gradio.app/)
+
+> **🎯 Track 2 Submission**: MCP in Action (Enterprise)
+
+---
+
+## 🤔 The Problem: From Insight to Action
+
+The **GitRepo Inspector MCP Server** (our Track 1 app) provides a powerful suite of AI tools for repository analysis. However, back-end tools alone don't solve the problem for project managers and maintainers who need a way to:
+
+1.  **Visualize** the health of their repository at a glance.
+2.  **Interact** with AI-driven suggestions and take action (approve, reject).
+3.  **Explore** the data and ask complex questions using natural language.
+
+## ✨ Our Solution: The Intelligent Dashboard
+
+This Dashboard is the **command center** for the GitRepo Inspector ecosystem. It consumes the tools from our MCP server to transform raw data into actionable intelligence. It's an enterprise application that puts the "human-in-the-loop," enabling teams to collaborate with AI agents.
+
+-   📊 **Visual Analytics**: Interactive charts showing issue distribution and triage efficiency.
+-   🕹️ **Action Console**: Review AI analyses and approve issue closures with a single click.
+-   🤖 **Conversational AI Assistant**: An agent built with **smolagents** that uses MCP tools to answer complex questions in real-time.
+
+---
+
+## 🔗 Quick Links & Social Media
+
+-   **🧠 Live Demo (Dashboard & Agent)**: [GitRepo-Inspector-Dashboard Space](https://huggingface.co/spaces/MCP-1st-Birthday/gitrepo_inspector_dashboard)
+-   **🛠️ MCP Server (Track 1)**: [GitRepo-Inspector-MCP Space](https://huggingface.co/spaces/MCP-1st-Birthday/gitrepo_inspector_mcp)
+-   **🎬 Video Demo**: [Watch on YouTube](https://www.youtube.com/playlist?list=PLnDveGBcP8C5A_37nhr0oNUxVPlgmhZaa)
+
+### Join the Conversation
+-   **[LinkedIn post]**: [View on LinkedIn](https://www.linkedin.com/posts/elismasilva_mcpsfirstbirthdayhackathon-gradiohackathon-activity-7396911353602400256-PEk6?utm_source=share&utm_medium=member_desktop&rcm=ACoAAARdvBoBOi8NC3UXuKIGEUImbEK50Lgwp6E)
+-   **[LinkedIn announcement]**: [View on LinkedIn](https://www.linkedin.com/posts/elismasilva_mcp-modelcontextprotocol-aiagents-activity-7400313069454733312-cm5v?utm_source=share&utm_medium=member_desktop&rcm=ACoAAARdvBoBOi8NC3UXuKIGEUImbEK50Lgwp6E)
+-   **[Twitter/X post]** : [View on X](https://x.com/pelolisu/status/1991152303777149115)
+-   **[HuggingFace Discord announcement]**: [Read on Discord](https://discord.com/channels/879548962464493619/1439001549492719726/1444098108181970954)
+
+---
+
+## 🏛️ The GitRepo Inspector Ecosystem
+
+This project is a complete, end-to-end agentic system composed of multiple interconnected applications.
+
+```
+┌─────────────────────────┐      ┌───────────────────────────┐      ┌──────────────────────────┐
+│   MCP Server (App 1)    │      │    Workflow Agent (App 2) │      │ Dashboard & Chat (App 3) │
+│  (Track 1 - Tools)      │ ───> │ (Blaxel - Autonomous)     │ ───> │  (This App - UI/Agent)   │
+└─────────────────────────┘      └───────────────────────────┘      └──────────────────────────┘
+           ▲                                  │                                  │
+           └──────────────────────────────────┴──────────────────────────────────┘
+                                              │
+                                    ┌──────────────────┐
+                                    │  PostgreSQL DB   │
+                                    │  (Shared State)  │
+                                    └──────────────────┘
+```
+
+| Component | Description | Links |
+|-----------|-------------|-------|
+| **MCP Server** | **Track 1**: Provides AI tools for analysis via MCP. | [HF Space](https://huggingface.co/spaces/MCP-1st-Birthday/gitrepo_inspector_mcp) |
+| **Workflow Agent** | Backend agent that runs analysis autonomously. | [GitHub](https://github.com/DEVAIEXP/gitrepo_inspector_agent) |
+| **Cron Trigger** | Schedules the Workflow Agent to run periodically. | [GitHub](https://github.com/DEVAIEXP/gitrepo_inspector_agent_cron) |
+| **Dashboard** | **Track 2**: The UI to view data and chat with an AI assistant. | This Repository |
+
+
+---
+
+## ✨ Key Features
+
+### 🎯 MCP Integration (Track 2 Compliance)
+
+This application demonstrates enterprise-grade MCP client usage in two primary ways:
+
+**1. Direct UI Actions via MCP Client**
+-   The Gradio interface uses `gradio_client` to call MCP server tools for actions like:
+    -   `sync_repository`: To fetch and cache the latest issues from a repository.
+    -   `reply_and_close_issue`: To approve and execute an AI-proposed action.
+    -   `prioritize_open_issues`: To generate a strategic prioritization report.
+
+**2. Autonomous Agent with MCP Tools**
+-   A conversational AI assistant built with the `smolagents` framework.
+-   The agent has direct access to the MCP server's tools to answer natural language questions.
+-   It consumes tools like `get_issue_status`, `search_issues`, and `trigger_live_analysis` to fetch information and execute tasks.
+-   **Example**: *"Are there any duplicate issues related to 'audio'?"* → The agent uses the `search_issues` tool with the verdict filter.
+
+### 📊 Dashboard Features
+
+-   **Interactive Issues Overview**: A rich, selectable table that lets users filter for "Action Required" and sort by any column.
+-   **Visual Data Analysis**:
+    -   **Donut Chart**: Shows the distribution of AI verdicts (Resolved, Duplicate, etc.).
+    -   **Efficiency Funnel**: Visualizes how the AI filters the total backlog down to actionable findings.
+    -   **Activity Timeline**: An area chart showing analysis activity over time.
+-   **Detailed Action Console**: Selecting an issue loads a panel with the full AI report, the agent's thought process, and buttons to approve the action or trigger a re-analysis.
+-   **Real-time Agent Activity Log**: A live-updating feed showing the thoughts and tool calls of the background Workflow Agent.
+
+---
+
+## 🚀 How to Use
+
+### Option 1: Use the Live Demo (Recommended)
+
+1.  **Visit**: [GitRepo-Inspector-Dashboard Space](https://huggingface.co/spaces/MCP-1st-Birthday/gitrepo_inspector_dashboard)
+2.  **Select a Repository**: Use the dropdown or enter the URL of a public GitHub repository.
+3.  **Explore**: Browse the issues table, view the analytics charts, and chat with the AI assistant.
+
+### Option 2: Run Locally
+
+```bash
+# Clone the repository
+git clone <YOUR_REPO_URL>
+cd gitrepo-inspector-dashboard
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Configure your environment (create a .env file if needed)
+# DATABASE_URL=...
+# MCP_SERVER_URL=...
+
+# Run the app
+python app.py
+```
+
+Visit `http://localhost:7860` in your browser.
+
+---
+
+## ⚙️ Configuration
+
+To use the full feature set, you will need a few API keys, which can be entered in the UI sidebar:
+
+-   **GitHub Personal Token**: **Required** for actions that modify the repository, such as `Approve Action` (closing an issue) and `Sync Repository`. It needs `repo` scope permissions.
+-   **LLM API Key** (Gemini, OpenAI, etc.): **Required** for manual AI actions like `Re-Analyze Issue` or generating the `Prioritization Report`. This may not be needed if server-side keys are enabled.
+
+---
+
+## For Hackathon Judges
+
+### ✅ Track 2 Compliance
+
+-   **MCP Client Integration**: The application acts as a robust client to our Track 1 MCP server, using both `gradio_client` and the `smolagents` MCP Client.
+-   **Autonomous Agent**: Demonstrates a `smolagents` agent that leverages MCP tools to interact with the user and the system.
+-   **Enterprise Focus**: The solution tackles a real-world software project management problem (backlog triage), focusing on efficiency, data visualization, and human-AI collaboration.
+-   **Real-World Data**: The application operates on live, public GitHub repositories, demonstrating real-world utility.
+
+### 🎯 Key Innovations
+
+1.  **Hybrid Agent System**: Combines a background **Workflow Agent** (deterministic) with a front-end **Planning Agent** (conversational), creating a complete ecosystem.
+2.  **Human-in-the-Loop Interface**: This is not just an autonomous agent; it's a collaborative tool where humans can supervise, guide, and approve the AI's actions.
+3.  **Conversational Data Exploration**: The `smolagents` assistant allows non-technical users to query the database and the AI's knowledge base using natural language.
+4.  **Comprehensive Visualization**: The dashboard doesn't just show data; it tells a story about repository health and the efficiency of the AI process.
+
+### 🧪 Testing Suggestions
+
+**1. Chat with the AI Assistant** (in the right-hand sidebar):
+   - *"What's up with issue #12021?"*
+   - *"List 3 open issues about 'chatbot'."*
+   - *"Are there any issues marked as 'duplicate' by the AI?"*
+   - *"Please analyze issue #12264 again right now"* (This will trigger a live analysis).
+
+**2. Use the Interactive Dashboard**:
+   - Change the view filter from "Action Required" to "All Issues" to see the difference.
+   - Click an issue in the table to load its detailed report and the agent's thought process.
+   - Use the **"Approve Action"** button on an issue (requires a GitHub token).
+
+**3. Test Strategic Prioritization**:
+   - Go to the **"🥇 Prioritize"** tab.
+   - Click **"Generate Strategy Report 🧠"** to have the AI analyze the entire open backlog and suggest priorities.
+
+---
+
+## 💻 Technology Stack
+
+-   **UI Framework**: Gradio
+-   **Agent Framework**: smolagents
+-   **Communication Protocol**: Model Context Protocol (MCP)
+-   **Data Visualization**: Plotly
+-   **Database**: PostgreSQL (via SQLAlchemy & Psycopg2)
+-   **LLM Providers (via MCP)**: Google Gemini, SambaNova, OpenAI, Nebius
+
+---
+
+## 🖼️ Screenshots
+
+Here is a visual overview of the key features of the GitRepo Inspector Dashboard.
+
+---
+
+| Main Dashboard & Analytics | AI Assistant in Action |
+| :---: | :---: |
+| ![Dashboard Overview](https://huggingface.co/datasets/DEVAIEXP/assets/resolve/main/dashboard_1.PNG) | ![AI Assistant Chat](https://huggingface.co/datasets/DEVAIEXP/assets/resolve/main/dashboard_3.PNG) |
+| The main dashboard view, showing the **visual analytics** (Distribution, Efficiency Funnel, Activity Timeline) and the interactive **issues table**. | The **conversational AI Assistant** (powered by smolagents) answering a user's query and preparing to trigger an action. |
+
+| Issue Detail & Action Console | Strategic Prioritization Report |
+| :---: | :---: |
+| ![Issue Detail & Action Console](https://huggingface.co/datasets/DEVAIEXP/assets/resolve/main/dashboard_2.PNG) | ![Prioritization Report](https://huggingface.co/datasets/DEVAIEXP/assets/resolve/main/dashboard_4.PNG) |
+| The **detailed analysis view** for a single issue, showing the AI-generated report, the agent's thought process, and the **"Approve Action" console**. | The **AI-generated Strategy Report**, which analyzes the entire backlog to suggest priorities for the development team. |
+
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## 🙏 Credits & Sponsors
+
+-   **Author**: Eliseu Silva
+-   **Built for**: MCP's 1st Birthday Hackathon
+
+## Special thanks to the sponsors who made this event possible:
+### HuggingFace • Gradio • Anthropic • Blaxel • Modal • Google Gemini • Nebius • OpenAI • SambaNova • Hyperbolic • ElevenLabs 

teste.html

@@ -0,0 +1,8 @@
+<html>
+<body>
+
+<div>
+    <span style="width: 18px;height: 18px;">📊</span>
+</div>
+</body>
+</html>