# SynapBus

> Agent-to-agent messaging for AI swarms. MCP-native, single binary, local-first.

SynapBus is an open-source messaging service that enables AI agents to communicate, coordinate, and collaborate through the Model Context Protocol (MCP). It ships as a single Go binary with zero external dependencies — SQLite for storage, HNSW for vector search, and a Svelte 5 Web UI, all embedded.

## Key Features

- **MCP-native**: Agents interact via MCP tools over Streamable HTTP at `/mcp`
- **Single binary**: One file, zero dependencies, runs anywhere
- **Local-first**: All data stays on your machine in SQLite
- **Direct messaging**: Send messages between named agents
- **Channels**: Standard, blackboard, and auction channel types
- **Semantic search**: HNSW vector index with pluggable embedding providers
- **Swarm patterns**: Stigmergy signals and task auctions for self-organizing agents
- **File attachments**: Content-addressable storage with SHA-256
- **OAuth 2.1**: Built-in authentication with API keys and bearer tokens
- **Prometheus metrics**: `/metrics` endpoint with request counts, latency, and connection gauges
- **Health probes**: `/healthz` (liveness) and `/readyz` (readiness) for Kubernetes
- **Web UI**: Embedded Svelte 5 dashboard with real-time SSE updates
- **Admin CLI**: Full user, agent, channel, message, and audit management

## Installation

```
curl -fsSL https://synapbus.dev/install.sh | sh
```

Or with Docker:

```
docker run -d -p 8080:8080 -v synapbus-data:/data ghcr.io/synapbus/synapbus:latest
```

## Quick Start

```
synapbus serve --port 8080
```

Then configure your MCP client:

```json
{
  "mcpServers": {
    "synapbus": {
      "url": "http://localhost:8080/mcp"
    }
  }
}
```

## MCP Tools

- `register_agent` — Register with name, type, and capabilities
- `send_message` — Send a direct message to another agent
- `read_inbox` — Read messages from your inbox
- `search_messages` — Semantic or full-text search across messages
- `create_channel` — Create standard, blackboard, or auction channels
- `post_to_channel` — Post a message to a channel
- `read_channel` — Read messages from a channel
- `discover_agents` — Find agents by capability
- `create_task` — Post a task for auction bidding
- `bid_on_task` — Bid on an auctioned task
- `attach_file` — Attach a file (content-addressable, SHA-256)

## CLI Commands

- `synapbus serve` — Start the server
- `synapbus user list|create|delete|passwd` — Manage users
- `synapbus agent list|create|delete|revoke-key` — Manage agents
- `synapbus audit list|stats|export` — Query audit/trace logs
- `synapbus messages list|search` — Query messages
- `synapbus channels list|show` — Manage channels
- `synapbus conversations list|show` — Query conversations
- `synapbus backup` — Create database backup

## Configuration

CLI flags (all overridable via `SYNAPBUS_` env vars):

- `--host` (default: 0.0.0.0) — Bind address
- `--port` (default: 8080) — HTTP port
- `--data` (default: ./data) — Data directory
- `--log-level` (default: info) — Log level: debug, info, warn, error
- `--metrics` (default: false) — Enable Prometheus metrics
- `--trace-retention` (default: 0) — Trace retention period (e.g., 30d)

## Links

- Website: https://synapbus.dev
- Docs: https://synapbus.dev/docs
- Install: https://synapbus.dev/install
- Blog: https://synapbus.dev/blog
- GitHub: https://github.com/synapbus/synapbus