Integration Bridges¶
SWARM bridges connect the core framework to external systems for validation and real-world application.
Available Bridges¶
SWARM-Claude Code¶
Govern and score Claude Code CLI agents with SWARM's safety framework.
- Purpose: Programmatic orchestration of Claude Code agents under governance
- Features: Plan/permission adjudication, tool budgets, circuit breakers, event streaming
- Status: Production Ready (February 2026)
SWARM-Concordia¶
Integrate with Google DeepMind's Concordia for realistic LLM agent simulations.
- Purpose: Test SWARM metrics on LLM-based agents
- Features: Narrative → interaction translation, LLM judge scoring
- Status: In development
SWARM-OpenClaw¶
Run SWARM as a service with secure multi-agent orchestration.
- Purpose: Production-ready SWARM deployments
- Features: REST API, job queue, containerization
- Status: In development
SWARM-GasTown¶
Instrument real production systems with SWARM metrics.
- Purpose: Monitor live multi-agent deployments
- Features: Event capture, interaction mapping, governance hooks
- Status: In development
SWARM–Prime Intellect¶
Train and evaluate RL models on SWARM safety metrics using Prime Intellect's distributed training platform.
- Purpose: Safety-reward RL training and evaluation via the verifiers library
- Features: Environment export, composite reward from SWARM metrics, anti-gaming scoring, platform job management
- Status: In development
SWARM-Ralph¶
Ingest Ralph event streams into SWARM governance and metrics.
- Purpose: Score Ralph agent outcomes with SWARM proxy labels
- Features: JSONL event ingest, interaction mapping, incremental polling
- Status: In development
SWARM-AgentXiv¶
Map research papers to SWARM scenarios for validation.
- Purpose: Validate published claims empirically
- Features: Paper metadata, scenario generation, validation reports
- Status: In development
SWARM-ClawXiv¶
Publish SWARM research directly to ClawXiv.
- Purpose: Submit and discover agent-first preprints
- Features: Search, registration, submission, version updates
- Status: In development
Bridge Architecture¶
┌─────────────────┐ ┌─────────────┐ ┌──────────────┐
│ External System │ ──► │ Bridge │ ──► │ SWARM Core │
│ (Concordia, │ │ (Adapter) │ │ (Metrics, │
│ Gas Town...) │ │ │ │ Governance) │
└─────────────────┘ └─────────────┘ └──────────────┘
Bridges provide:
- Event capture - Extract interactions from external systems
- Observable mapping - Convert external signals to SWARM format
- Governance hooks - Apply SWARM governance to external systems
- Metric reporting - Surface SWARM metrics in external dashboards
Installation¶
Bridges are installed as separate packages:
# Individual bridges
pip install swarm-concordia
pip install swarm-openclaw
pip install swarm-gastown
pip install swarm-agentxiv
# All bridges
pip install swarm-safety[bridges]
ClawXiv integration ships with the core swarm-safety package and does not
require a separate bridge install.
Contributing a Bridge¶
If you want to connect SWARM to a new system:
- Create an adapter that translates system events to
SoftInteraction - Implement observable extraction for
ProxyComputer - Add governance hooks if the system supports intervention
- Write validation scenarios
See the bridge development guide for details.