Open-source layered multi-agent orchestration

357 agent identities. 6 business layers.
One bounded execution model.

Python · Anthropic Claude · portable .mv2 memory via a Rust bridge · per-layer cost controls · BashSecurityGate.

Read the source →$pip install -e 'packages/techtide-swarm[dev]'
357
agent identities
7
layers (1 meta + 6 domain)
13
security patterns
The honest bit

What "357" actually means

357 agents means 357 distinct YAML roster entries, materialized at runtime — for example sales-outreach-specialist-015. It is not a claim about 357 parallel long-running LLM sessions. Layer execution uses bounded concurrency.

The roster is generated by a script and verified in docs/VERIFY.md. Inspect both before trusting the count.

Architecture

A meta-layer that conducts six business layers.

The Conductor reads strategy and curated memory, then dispatches tasks downward. Each business layer holds its own roster, budget, and memory store.

Management10 agentsConductor · strategy · memory curationSales62
Outreach, qualification, follow-up
Support55
Triage, resolution, escalation
Marketing68
Content, campaigns, lifecycle
SEO47
Audit, keywords, on-page, links
Research58
Discovery, synthesis, briefs
Operations57
Process, ops automation, ops QA

10 management agents · 347 domain agents · 357 total identities

What's different

Four design decisions you can audit.

01

Portable .mv2 memory

Single-file Memvid store per agent layer. WAL-based crash safety, full-text and vector search. No database server to run.

02

Business-layer ontology

Six domain layers plus management meta-agents. Not just 'agent A talks to agent B' — work has a place to live.

03

Layered cost controls

Per-agent budget caps. Per-layer daily limits. Automatic model downgrade at 80% utilization.

04

BashSecurityGate

13-pattern regex validator wired into the Bash tool. Blocks destructive commands, secret exfiltration, dangerous system ops. 50+ tests.

Command line

One CLI. Eight verbs.

The whole framework is reachable from swarm. Dashboards, planning, evaluation and the memory dream cycle live in the same tool.

~/swarm
$ swarm run <task> # routes through Conductor
$ swarm boot # loads 357-agent roster
$ swarm agent --list # all agents
$ swarm dream # memory consolidation
$ swarm plan <task> # deep planning via Claude Opus
$ swarm eval # 5-task benchmark
$ swarm status # runtime dashboard
$ swarm cost # spend dashboard
Feature maturity

Where each piece actually is.

No "production-ready" gloss. Build on the Stable bits, experiment with Beta, expect changes on Alpha, treat Stub as a placeholder.

FeatureStatusNotes
Agent runtimeBetaCore abstraction stabilizing
Swarm orchestratorBetaConductor + bounded layer execution
CLIStableMost verbs stable; a few subcommands Beta
Memory (.mv2)BetaWAL crash-safety landed; APIs may shift
BashSecurityGateStable13 patterns, 50+ tests
Cost controlsBetaPer-agent + per-layer caps; downgrades wired
Dream cycleAlphaMemory consolidation, expect rough edges
Eval harnessAlpha5-task benchmark, scoring evolving
WebSearch toolStubInterface in place, provider not wired
Honest comparison

vs. LangGraph, CrewAI, OpenAI Agents SDK.

The other frameworks are good tools. Swarm 357 picks a narrower opinion: layered business ontology, portable single-file memory, per-layer cost controls.

Swarm 357LangGraphCrewAIOpenAI Agents SDK
Business-layer ontologySix domain layers + metaGraph of nodesCrew/role free-formAgent + tools
Memory storePortable .mv2, single fileBring your ownBring your ownThreads / vector store
Per-layer cost capsBuilt in, auto-downgradeDIYDIYPer-run limits
Bounded layer executionFirst-classManual via graphManualManual
Bash security gateBuilt in, 13 patternsNot includedNot includedNot included
LicenseApache 2.0MITMITProprietary SDK

Read it. Run it. Argue with it.

Apache 2.0. Inspect the roster, run the eval, file an issue.

github.com/TechTideOhio/swarm-357 →$pip install -e 'packages/techtide-swarm[dev]'