agent-mesh-router

Multi-agent communication, task routing, and workflow orchestration

Part of the AumOS open-source agent infrastructure portfolio.

Features

• Five routing strategies — CapabilityMatchRouter, CostAwareRouter, RoundRobinRouter, LeastLoadedRouter, and CompositeRouter (weighted combination) — all implementing a common RoutingStrategy ABC
• Async MessageBroker with in-memory pub/sub, dead-letter queue support, and backpressure monitoring that throttles producers when consumers fall behind
• Five workflow patterns: SequentialWorkflow, ParallelWorkflow, HierarchicalWorkflow, CompetitiveWorkflow (first-result wins), and ConsensusWorkflow (majority agreement)
• Fleet registry with health checking and a load balancer that routes only to healthy agents based on current load metrics
• Transport adapters for HTTP, gRPC, Redis pub/sub, and Kafka so the same router can operate across different message infrastructure
• MessageEnvelope with typed priority levels, routing metadata, TTL, and checksum validation for tamper detection
• OpenTelemetry tracing middleware that adds trace context propagation to every routed message

Quick Start

Install from PyPI:

pip install agent-mesh-router

Verify the installation:

agent-mesh-router version

Basic usage:

import agent_mesh_router

# See examples/01_quickstart.py for a working example

Documentation

• Architecture
• Contributing
• Changelog
• Examples

Enterprise Upgrade

For production deployments requiring SLA-backed support and advanced integrations, contact the maintainers or see the commercial extensions documentation.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

Apache 2.0 — see LICENSE for full terms.

Part of AumOS — open-source agent infrastructure.