Add production deployment documentation and systemd service support

- 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>
This commit is contained in:
anthonyrawlins
2025-07-12 19:52:03 +10:00
parent e8244a783b
commit 88d54c8408
5 changed files with 492 additions and 3 deletions

View File

@@ -1,6 +1,6 @@
# Bzzz + Antennae: Distributed P2P Task Coordination
Bzzz is a P2P task coordination system with the Antennae meta-discussion layer for collaborative AI reasoning.
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
@@ -8,6 +8,7 @@ Bzzz is a P2P task coordination system with the Antennae meta-discussion layer f
- **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
@@ -18,6 +19,82 @@ Bzzz is a P2P task coordination system with the Antennae meta-discussion layer f
- `logging/` - Hypercore-based distributed logging
- `cmd/` - Command-line interfaces
## Quick Start
### Building from Source
```bash
go build -o bzzz
```
### Running as Service
Install Bzzz as a systemd service for production deployment:
```bash
# 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
```bash
./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**: `always` with 10-second delay
- **Security**: NoNewPrivileges, PrivateTmp, ProtectSystem
- **Logging**: Output to systemd journal with `bzzz` identifier
- **Resource Limits**: 65536 file descriptors, 4096 processes
## Development Status
This project is being developed collaboratively across the deepblackcloud cluster:
@@ -28,5 +105,13 @@ This project is being developed collaboratively across the deepblackcloud cluste
## Network Configuration
- **Local Network**: 192.168.1.0/24
- **mDNS Discovery**: Automatic peer discovery
- **Docker Deployment**: Host networking mode for P2P connectivity
- **mDNS Discovery**: Automatic peer discovery with service tag `bzzz-peer-discovery`
- **PubSub Topics**:
- `bzzz/coordination/v1` - Task coordination messages
- `antennae/meta-discussion/v1` - Collaborative reasoning
- **Security**: Message signing and signature verification enabled
## Related Projects
- **[Hive](https://github.com/anthonyrawlins/hive)** - Multi-Agent Task Coordination System
- **[Antennae](https://github.com/anthonyrawlins/antennae)** - AI Collaborative Reasoning Protocol