HiveSec Ecosystem Hub — AI Security Dashboard

Security monitoring for AI agent fleets. Centralized dashboard to discover agents, run scans, track vulnerabilities, and maintain audit trails across your entire autonomous ecosystem.

✨ Features

• 🔍 Agent Auto-Discovery — Automatically finds agents from agents/ folder
• 🛡️ Unified Findings Store — SQLite (dev) or Postgres (prod) for scan results
• 🧪 Pluggable Scanners — Add new security agents by dropping Python files
• 📊 Real-Time KPIs — Alert counts, agent status, trends
• 🔬 Scan Monitoring — Launch scans, watch progress, view detailed results
• 📜 Audit Trails — Full logging for compliance and forensics
• 🐳 Docker Ready — Compose setup with optional Postgres

🚀 Quick Start

git clone https://github.com/GBOYEE/HiveSec-Ecosystem-Hub.git
cd HiveSec-Ecosystem-Hub
pip install -r requirements.txt
streamlit run Home.py

Open: http://localhost:8501

Or with Docker:

docker compose up -d

🏗️ Architecture

flowchart TD
    UI[Streamlit Dashboard]
    REG[Agent Registry]
    DB[(Database)]
    AG1[Agent 1]
    AG2[Agent 2]
    AGN[Agent N]

    UI --> REG
    REG --> AG1 & AG2 & AGN
    AG1 & AG2 & AGN --> DB
    UI --> DB

    subgraph "Agents"
        AG1
        AG2
        AGN
    end

Loading

Agents auto-discovered from agents/ folder. Each implements:

def name() -> str: ...
def scan(target: str) -> List[Finding]: ...
def metadata() -> dict: ...

See docs/architecture.md.

📦 Tech Stack

Layer	Technology
UI	Streamlit
Language	Python 3.11+
Database	SQLite (dev) / PostgreSQL (prod)
Cache	Redis (optional)
Agents	Pluggable Python modules

🧪 Testing & CI

pytest tests/ -v --cov=hivesec

CI runs on push: lint, tests, coverage.

📚 Documentation

• Getting Started
• Agent Development Guide
• API Reference
• Contributing

🎯 Roadmap

• OAuth2 authentication for dashboard
• Advanced filtering & saved searches
• Email/Slack notifications for critical findings
• Multi-tenant support
• Agent marketplace (publish/share scanners)

🤝 Contributing

Add new security agents! Create agents/my_scanner.py implementing the scan() interface and submit a PR.

See CONTRIBUTING.md for guidelines.

📄 License

MIT — see LICENSE.

---

Built by Oyebanji Adegboyega • Portfolio • @Gboyee_0