Contra Swarm
Coordinate fleets of AI agents that decompose complex tasks, collaborate in real time, and deliver results no single model can achieve alone.
About Contra Swarm
Contra Swarm is a production-grade multi-agent orchestration runtime. It is what you reach for when a prototype stops being a prototype and needs to run against real user traffic, real SLAs, and real monitoring. Where most agent frameworks optimize for research-code expressiveness, Contra Swarm optimizes for the parts of the system that break at 3am: strict typed handoffs, durable replayable state, synchronous observability, and graceful degradation on model timeouts.
The runtime was extracted from an internal orchestration layer Contra Collective built for enterprise clients running autonomous operations workflows. Before it was open source, it was the execution spine of a fleet of agents triaging customer operations, routing refunds, managing inventory escalations, and writing back to ERPs — with the same pager-rotation expectations as any other tier-1 production service. Every feature in the current release survived a client production incident before it shipped publicly.
If you are evaluating it against LangGraph, CrewAI, or AutoGen: Contra Swarm is opinionated where the others are flexible. That is the point. You do not need five ways to wire an agent — you need the one way that survives a crashed worker, a 429 from Anthropic, and a supervisor re-plan all at the same time.
What It Does
Automatic task decomposition and delegation
Real-time inter-agent communication
Configurable agent roles and specializations
Human-in-the-loop approval gates
Parallel and sequential execution modes
Result aggregation and conflict resolution
Plugin architecture for custom agent types
Comprehensive execution logging and replay
Key Features
Multi-agent orchestration
Task decomposition
Intelligent coordination
Extensible architecture
Built With
The technologies powering Contra Swarm.
Why Contra Swarm
Honest notes on the closest comparable tools and where Contra Swarm differs.
LangGraph
The closest comparable. More flexible API and wider community adoption. Contra Swarm adds stricter typing at the graph level and Postgres-backed durable state by default.
CrewAI
Excellent for prototyping agent crews. Contra Swarm targets the production deployment phase CrewAI intentionally deprioritizes.
Microsoft AutoGen
Research-first framework. Strong for multi-agent experiments, less focused on the operability requirements Contra Swarm centers.
Custom LangChain Expression Language pipelines
What most teams start with. Contra Swarm is frequently the tool they migrate to once they hit the operability wall LCEL does not clear.
Common Questions
What AI providers does Contra Swarm support?
Contra Swarm works with OpenAI, Anthropic, Google, and any OpenAI-compatible API endpoint.
Can I define custom agent roles?
Yes. Agents are fully configurable with custom system prompts, tool access, and coordination rules.
Is there a free tier?
Contra Swarm offers a free tier for individual use. Team and enterprise plans are available for production workloads.
Other Projects
Linear CLI
A powerful command-line interface for Linear.app that brings issue tracking to your terminal.
Switchboard
Manage unlimited accounts across 25+ services in one beautiful desktop application.
Shopify Monitor
Command-line tool for monitoring Shopify stores. Track inventory, price changes, and product availability.
Try
Contra Swarm
Check it out on GitHub, open an issue, or contribute to the project.