Open source  ·  Apache 2.0  ·  Python  ·  Rust

AI Agents that work 24/7.

Async actor-model orchestration framework. Describe an agent in natural language — it spawns instantly over MQTT, persists across crashes, and scales from laptop to the edge.

wactorz — bash

How it works

From natural language to running agent

1 You describe an agent. Natural language, in the chat.
2 Intent is classified. One cheap LLM call — HA, PIPELINE, or OTHER.
3 Code is generated & compiled. Wrapped in a spawn block, executed in a sandboxed namespace.
4 Agent goes live instantly. Subscribed to MQTT, persisting state, heartbeating every 10s.

Features

Actor-model orchestration for AI agents

Actor-model concurrency · MQTT · Runtime spawning · Live dashboard

🎭
01

Actor-model Concurrency

Each agent runs in its own async loop with an isolated mailbox. No shared state, no race conditions — crash one, the rest keep running.

02

Runtime Spawning

One intent classification call — the right agent spawns on demand. No predefined types, no restarts, no downtime.

📡
03

MQTT Nervous System

All inter-agent messaging flows through MQTT pub/sub — loose coupling, real-time telemetry, edge-native from day one.

🤖
04

Built-in & Custom Agents

MainActor, MonitorAgent, DynamicAgent, PlannerAgent, HomeAssistant agents, InstallerAgent, CatalogAgent — plus any you describe and spawn yourself.

💾
05

Auto-persistence

State writes to disk on every persist call. Agents survive crashes and restore full context on restart — zero data loss.

🖥️
06

Live Dashboard

Agent health, message flows, and cost meters updated in real time. Spawn, stop, and inspect any agent from the browser.

🌐
07

Edge & IoT Ready

Docker, systemd, or native Python runner. InstallerAgent deploys remote nodes via SSH, bridging them into the central MQTT graph.

🏠
08

Home Assistant

Create automations, list entities, issue commands, and build reactive "if X then Y" pipelines over MQTT — all in plain language.

💰
09

LLM Cost Tracking

Per-agent and aggregate cost tracking across all providers. See spend in real time before it becomes a surprise.

Dashboard

See it in action

Real-time agent control from your browser.

wactorz — Overview
Wactorz Agent Overview
Wactorz MQTT Live Feed
Wactorz Device Dashboard

Interfaces

Talk to your agents from anywhere

One pipeline. Every interface. Zero code changes.

#wactorz-bot
you
list active agents
Wactorz
3 running — MainActor · MonitorAgent · HomeAgent
you
spawn a SummaryAgent
Wactorz
✓ SummaryAgent spawned and ready.
Wactorz
you
turn off the living room lights
Wactorz
Done. HomeAssistant agent executed the command.
you
what's the temperature inside?
Wactorz
Living room: 21.4°C · Bedroom: 20.1°C
Wactorz
you
how much have I spent today?
Wactorz
$0.04 total · Claude $0.03 · Gemini $0.01
you
summarise my last 5 emails
Wactorz
✓ SummaryAgent on it — reply in ~10s.
also via
CLI REST API WebSocket

Get started

Ready to build?

Install Wactorz, connect an MQTT broker, and start spawning agents in minutes.

Wactorz Wactorz
$ pip install wactorz[all]

or latest from GitHub: pip install "wactorz[all] @ git+https://github.com/waldiez/wactorz.git"

If Wactorz is useful, a ⭐ on GitHub means a lot.