Agent Registry Hub

A modern agent registry system with real-time monitoring and visualization capabilities.

🚀 Quick Start

Start Development Environment

# Start development server (with hot reload)
uv run python start_dev.py

Register Test Agents

# Register example agents
uv run python register_test_agent.py

Access Application

• Frontend: http://localhost:8000
• API Documentation: http://localhost:8000/docs
• Health Check: http://localhost:8000/api/v1/health

✨ Features

• 🤖 Agent Registration Management: Support for multiple agent types
• 📊 Real-time Monitoring: Live agent status and statistics
• 🌐 Network Visualization: D3.js-powered agent network topology
• 🔄 Status History: Track and view agent status changes
• 🎨 Modern UI: Responsive design with mobile support
• ⚡ Hot Reload: Development environment with code hot reload

🛠️ Tech Stack

Backend

• FastAPI: Modern Python web framework
• SQLAlchemy: ORM database operations
• SQLite: Lightweight database
• Uvicorn: ASGI server

Frontend

• Vanilla JavaScript: No framework dependencies
• D3.js: Data visualization
• CSS3: Modern styling
• HTML5: Semantic markup

📁 Project Structure

AgentHub/
├── backend/
│   └── main.py              # FastAPI backend service
├── frontend/
│   ├── index.html           # Main page
│   └── app.js               # Frontend logic
├── start_dev.py             # Development startup script
├── register_test_agent.py   # Test script
├── DEVELOPMENT.md           # Development guide
└── pyproject.toml           # Project configuration

🔧 Development Guide

See DEVELOPMENT.md for detailed development environment setup and usage instructions.

📝 API Endpoints

Agent Management

• POST /api/v1/agents/register - Register new agent
• GET /api/v1/agents - Get all agents
• GET /api/v1/agents/{agent_id} - Get specific agent
• POST /api/v1/agents/{agent_id}/status - Update agent status
• GET /api/v1/agents/{agent_id}/status/history - Get status history

System

• GET / - Homepage
• GET /api/v1/health - Health check

🎯 Use Cases

• Microservices Architecture: Manage and monitor distributed services
• AI Agent Systems: Coordinate multiple AI agents
• IoT Device Management: Monitor IoT device status
• Task Scheduling Systems: Manage task executors
• API Gateway: Service discovery and load balancing

🤝 Contributing

Issues and Pull Requests welcome!

📄 License

MIT License