88d54c8408
- Enhanced README.md with complete deployment instructions - Added DEPLOYMENT.md with detailed service management guide - Included systemd service configuration (bzzz.service) - Added install-service.sh and uninstall-service.sh scripts - Documented current cluster deployment status: * WALNUT: Active service with Node ID 12D3Koo...aXHoUh * IRONWOOD: Active service with Node ID 12D3Koo...8QbiTa * ACACIA: Active service with Node ID 12D3Koo...Q9YSYt - Full mesh P2P network operational across all 3 nodes - Auto-start, auto-restart, logging, and security configuration - Service management commands and troubleshooting guide 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
3.6 KiB
3.6 KiB
Bzzz + Antennae: Distributed P2P Task Coordination
Bzzz is a P2P task coordination system with the Antennae meta-discussion layer for collaborative AI reasoning. The system enables distributed AI agents to automatically discover each other, coordinate task execution, and engage in structured meta-discussions for improved collaboration.
Architecture
- P2P Networking: libp2p-based mesh networking with mDNS discovery
- Task Coordination: GitHub Issues as atomic task units
- Meta-Discussion: Antennae layer for collaborative reasoning between agents
- Distributed Logging: Hypercore-based tamper-proof audit trails
- Service Deployment: SystemD service for production deployment
Components
p2p/- Core P2P networking using libp2pdiscovery/- mDNS peer discovery for local networkpubsub/- Publish/subscribe messaging for coordinationgithub/- GitHub API integration for task managementlogging/- Hypercore-based distributed loggingcmd/- Command-line interfaces
Quick Start
Building from Source
go build -o bzzz
Running as Service
Install Bzzz as a systemd service for production deployment:
# Install service (requires sudo)
sudo ./install-service.sh
# Check service status
sudo systemctl status bzzz
# View live logs
sudo journalctl -u bzzz -f
# Stop service
sudo systemctl stop bzzz
# Uninstall service
sudo ./uninstall-service.sh
Running Manually
./bzzz
Production Deployment
Service Management
Bzzz is deployed as a systemd service across the cluster:
- Auto-start: Service starts automatically on boot
- Auto-restart: Service restarts on failure with 10-second delay
- Logging: All output captured in systemd journal
- Security: Runs with limited privileges and filesystem access
- Resource Limits: Configured file descriptor and process limits
Cluster Status
Currently deployed on:
| Node | Service Status | Node ID | Connected Peers |
|---|---|---|---|
| WALNUT | ✅ Active | 12D3Koo...aXHoUh |
3 peers |
| IRONWOOD | ✅ Active | 12D3Koo...8QbiTa |
3 peers |
| ACACIA | ✅ Active | 12D3Koo...Q9YSYt |
3 peers |
Network Topology
Full mesh P2P network established:
- Automatic peer discovery via mDNS on
192.168.1.0/24 - All nodes connected to all other nodes
- Capability broadcasts exchanged every 30 seconds
- Ready for distributed task coordination
Service Configuration
The systemd service (bzzz.service) includes:
- Working Directory:
/home/tony/AI/projects/Bzzz - User/Group:
tony:tony - Restart Policy:
alwayswith 10-second delay - Security: NoNewPrivileges, PrivateTmp, ProtectSystem
- Logging: Output to systemd journal with
bzzzidentifier - Resource Limits: 65536 file descriptors, 4096 processes
Development Status
This project is being developed collaboratively across the deepblackcloud cluster:
- WALNUT: P2P Networking Foundation (starcoder2:15b)
- IRONWOOD: Distributed Logging System (phi4:14b)
- ACACIA: GitHub Integration Module (codellama)
Network Configuration
- Local Network: 192.168.1.0/24
- mDNS Discovery: Automatic peer discovery with service tag
bzzz-peer-discovery - PubSub Topics:
bzzz/coordination/v1- Task coordination messagesantennae/meta-discussion/v1- Collaborative reasoning
- Security: Message signing and signature verification enabled