How to Install Your First Swarm Agent

Overview

1. Python 3.8+
2. Linux environment (shared hosting, VPS, or bare metal)
3. Pip access
4. Optional: domain name for cert generation

⚙️ Step 1: Install MatrixSwarm

pip install matrixswarm git clone https://github.com/matrixswarm/matrixswarm.git cd matrixswarm

🧠 Step 2: Initialize the Workspace (the Hive)

matrixswarm-boot --init --install-path /srv/hive

.matrixswarm/
├── agent/
├── pod/
├── comm/
├── boot_directives/
└── certs/

Step 3: Generate Certs (Optional but Recommended)

matrixswarm-gencerts yourdomain.com --name "SwarmHQ"

Creates SSL certs for both the WebSocket and GUI components. Stored in:

.matrixswarm/certs/https_certs/

.matrixswarm/certs/socket_certs/

🚀 Step 4: Launch the Swarm

What this does:

Reads agent hierarchy from /boot_directives/

Spawns agents into /pod/

Initializes comms in /comm/

Routes live logs, commands, heartbeats

🧭 Step 5: Access Your Swarm Dashboard

If you deployed with matrix_https and matrix_gui, visit:

https://yourdomain.com:8765

🧹 Terminate the Swarm (if needed)

matrixswarm-kill --universe ai --cleanup

This safely shuts down all agents and prunes the boot directory.

🛰️ What Next?

Customize directives in boot_directives/

Build new agents using BootAgent

Wire up reflex logic, uptime monitoring, or full automation via .cmd files