MatrixSwarm

Automation that breathes. The Swarm that won’t die.

Not a Tool. A Digital Army.

  • ✓ Agents repair, reboot, and protect themselves.
  • ✓ No SaaS. No subscriptions. No downtime.
  • ✓ You own it. You control it.

Your Swarm, Your Rules.

  • ✓ Plug-and-play agents: add, upgrade, or kill jobs in seconds.
  • ✓ True digital immortality—your swarm, your heartbeat, your rules.

Ready to Wake Your Swarm?

🚀 Download Now

Replace SaaS fees and single-purpose scripts with one self-healing, agent-powered automation platform. No limits. No learning curve. Just automation—on your terms.

MatrixSwarm Animation

Explore the Swarm

Browse community-powered agents or contribute your own.

Agents

Monitoring

Log Watcher

`log_watcher` is a flexible and robust agent designed to monitor any specified log file in real-time. It tails the file, intelligently classifies new entries based on custom rules, and reports them to the swarm for analysis, making it a foundational sensor for system and application monitoring.

Maintainer: matrixswarm July 31, 2025

Security

Permissions Guardian

`permissions_guardian` is a mission-based agent responsible for enforcing file and directory permissions across designated paths. It detects discrepancies against a configured policy and optionally corrects them. Each run is single-pass and stateful, leaving behind a verifiable, encrypted change history.

Maintainer: matrixswarm July 29, 2025

Security

Tripwire Lite

The `tripwire_lite` agent acts as a real-time file integrity monitor. It uses the `inotify` library to watch specified directories and logs any changes, creations, or deletions that occur within them. This makes it an essential tool for security and for monitoring critical application code for unauthorized changes.

Maintainer: matrixswarm July 29, 2025

Monitoring

Nginx Watchdog

The `nginx_watchdog` is a service monitor that ensures the Nginx web server remains online and healthy.

Maintainer: matrixswarm July 29, 2025

Docs

Directives & The Hive

🎪 How Do You Cram a Swarm of Agents inside a Clown Car?

Step right up, children of the cloud! Ready for a carnival trick your ops team won’t believe? Imagine stuffing your entire AI automation swarm into a single, tamper-proof, encrypted artifact—no Docker, no plugins, no side files. Just one directive, and a circus of agents ready to roll anywhere, anytime... (Cue the calliope music)

Maintainer: matrixswarm July 29, 2025

Security Best Practices

How to Use the Directive Encryption Tool

Accreditation This guide was prepared in collaboration with Gemini, the swarm's designated AI construct for documentation and analysis. This guide explains how to use the matrixswarm-encrypt-directive tool to secure your boot directives. This tool encrypts an entire directive file, protecting sensitive information like API keys, private keys, and file integrity hashes before the swarm is even launched. Overview The primary function of this tool is to take a plaintext directive file (.py or .json) and output an encrypted version. Its key features include: AES-GCM Encryption: Encrypts the entire directive with a strong, authenticated encryption cipher. Automatic Key Generation: Can automatically generate secure RSA keypairs for agents directly within the directive, which is ideal for agents that need to decrypt messages from external sources. Future-Proof Security: This tool is the foundation for advanced security patterns, such as storing private keys for matrix_https and matrix_websocket to enable mutually authenticated communication, and for storing tripwire_lite file hashes to ensure the integrity of the swarm's core files.

Maintainer: matrixswarm July 28, 2025

Use Cases & Examples

How a Secure Message is Processed in MatrixSwarm

This guide explains the end-to-end encrypted journey of a message, from a visitor on your website to a notification for your team. This process ensures that a submitted message is never stored in plaintext on the web server, providing a high level of security. Overview Front-End: A standard PHP web application. Back-End: The Python-based MatrixSwarm. Encryption: Hybrid RSA + AES-GCM. Result: A secure, automated pipeline for handling external communications.

Maintainer: matrixswarm July 28, 2025

Getting Started

How to Install Your First Swarm Agent

MatrixSwarm isn’t a plugin. It’s not a daemon. It’s not trapped inside Docker. It’s a file-driven, resurrection-capable swarm OS that runs beside your system, not under it. This guide walks you through deploying your first Swarm universe, from zero to operational GUI, in 5 steps—no containers, no headaches.

Maintainer: matrixswarm July 23, 2025

News

Agent Spotlight

Why WordPress Needs the Swarm

WordPress is the world’s most popular platform—but also the most attacked, most broken, and most plugin-dependent. MatrixSwarm changes the game: you get true self-healing, hands-off automation, and total freedom from plugin ransom, SaaS lock-in, and late-night admin emergencies. If you want your site to run like a fortress—this is where you begin.

Maintainer: matrixswarm July 25, 2025