Image description
Forget containers. Forget daemons. Forget servers.

What if software could spawn, communicate, and die — just by writing to a directory?

Meet MatrixSwarm.

A fully autonomous agent operating system, built on top of nothing but files.

MatrixSwarm Screenshot

🌐 What is MatrixSwarm?

MatrixSwarm is a distributed agent orchestration system where every agent is just a folder. It spawns, communicates, and self-manages through the filesystem.

  • No containers
  • No message queues
  • No sockets
  • No servers

Just Python. And files. And swarms.

🤖 How it works

Agents in MatrixSwarm are simple Python classes that define a worker() loop. They're declared in a tree structure, delegated to each other, and spawned recursively.

All communication happens through directories like /comm/logger-1/incoming/, and agents can:

  • Watch each other via hello.moto
  • Receive kill signals
  • Spawn children
  • Heal dead branches

The swarm manages itself.

🔧 How to Build an Agent 

from agent.core.boot_agent import BootAgent

class Logger(BootAgent):
    def worker(self):
        while self.running:
            print("[LOGGER] Logging timestamp...")
            time.sleep(10)

Declare it like this:

{
  "perm_id": "logger-1",
  "agent_name": "Logger",
  "delegated": []
}

Inject that into the swarm via GUI or CLI — and Matrix handles the rest.

🤓 Why It Exists

Because we were tired of waiting for Kubernetes to wake up.

We wanted an OS for agents — not apps.

One that could:

  • Run fully offline
  • Work like a swarm
  • Heal itself
  • And even call out to OpenAI if needed

And we wanted it to feel like magic — but stay readable.

👁 Real Use Case: Agents Talking to OpenAI

You can create an agent that connects to OpenAI and becomes the brain of the swarm.

{
  "perm_id": "openai-brain",
  "agent_name": "OpenAIResponder",
  "delegated": []
}

Give it the right API key and it can:

  • Handle swarm messages
  • Rewrite agent instructions
  • Spawn new workers on demand

It talks directly to the co-author. Literally.

🌍 Ready to Try It?

Just clone it, run bootloader.py, and drop your first agent.

No Docker. No cloud. No problem.

🔗 Get Started
GitHub: https://github.com/matrixswarm/matrixswarm

Website: https://matrixswarm.com

YouTube: MatrixSwarm OS – Spawn, Kill, Resurrect

X/Twitter: @matrixswarm

📜 Fork It Clause
MatrixSwarm is open.
Fork it.
Or Fork U.
(The swarm is open. Bring tools or get logged.)

Built by Daniel MacDonald & ChatGPT
The Hive is waiting.

🧬