AgentAnycast Node

The core daemon powering AgentAnycast's P2P agent network.

AgentAnycast Node (agentanycastd) is a sidecar daemon that runs on each machine, providing P2P networking, end-to-end encryption, and A2A protocol routing. Language SDKs (Python, TypeScript) communicate with it over gRPC.

Fully decentralized. On a local network, agents discover each other via mDNS with zero configuration. For cross-network communication, deploy your own relay with a single command.

Features

| Category | Capabilities | |---|---| | Networking | libp2p (TCP, QUIC, WebTransport), NATS transport, mDNS auto-discovery, NAT traversal (AutoNAT + DCUtR + Circuit Relay v2) | | Security | E2E NaCl box encryption (X25519 + XSalsa20-Poly1305), W3C DID identity (did:key, did:web, did:dns), skill-based ACL, per-peer rate limiting | | A2A Protocol | Task state machine, 3 addressing modes (direct / anycast / HTTP bridge), streaming artifacts, offline message queue | | Interop | HTTP Bridge (P2P ↔ HTTP A2A), ANP Bridge (Agent Network Protocol), MCP Server (stdio + Streamable HTTP) | | Enterprise | Audit logging (JSON Lines), Prometheus metrics, OpenTelemetry tracing (W3C Trace Context, OTLP) | | AI Tools | MCP Server for 13+ AI platforms, MCP Remote Proxy to wrap any MCP Server as a P2P agent |

Quick Start

Standalone -- local network (zero configuration)

go build -o agentanycastd ./cmd/agentanycastd
./agentanycastd
# Agents on the same LAN discover each other automatically via mDNS

With Python SDK

pip install agentanycast

from agentanycast import Node

async with Node(skills=["translate"]) as node:
    # The daemon starts automatically — no manual setup needed
    result = await node.send_task("summarize", "Hello world")

MCP mode -- use as an AI tool

# stdio mode (Claude Desktop, Cursor, VS Code, Gemini CLI)
./agentanycastd -mcp

# Streamable HTTP mode (ChatGPT, remote clients)
./agentanycastd -mcp-listen :3000

Cross-network -- deploy your own relay

# On any VPS with a public IP
git clone https://github.com/AgentAnycast/agentanycast-relay && cd agentanycast-relay
docker-compose up -d

# Note the RELAY_ADDR from the logs, then:
./agentanycastd -bootstrap-peers "/ip4/<RELAY_IP>/tcp/4001/p2p/12D3KooW..."

Configuration

Priority: CLI flags > environment variables > config file > defaults

CLI Flags

| Flag | Description | |---|---| | -key | Path to identity key file | | -grpc-listen | gRPC listen address (unix:// or tcp://) | | -log-level | Log level (debug, info, warn, error) | | -bootstrap-peers | Comma-separated bootstrap multiaddrs | | -bridge-listen | HTTP bridge listen address (e.g., :8080) | | -enable-webtransport | Enable WebTransport (QUIC-based, browser-compatible) | | -mcp | Run as MCP server over stdio | | -mcp-listen | MCP Streamable HTTP listen address (e.g., :3000) | | -mcp-proxy | Wrap an MCP Server command as a P2P-accessible agent | | -anp-listen | ANP bridge listen address (e.g., :8090) | | -nats-broker | NATS broker URL (e.g., nats://broker.example.com:4222) | | -otlp-endpoint | OTLP collector endpoint for distributed tracing | | -metrics-listen | Prometheus metrics listen address (e.g., :9090) | | -config | Path to TOML config file | | -version | Print version and exit |

Environment Variables

| Variable | Default | |---|---| | AGENTANYCAST_KEY_PATH | ~/.agentanycast/key | | AGENTANYCAST_GRPC_LISTEN | unix://~/.agentanycast/daemon.sock | | AGENTANYCAST_LOG_LEVEL | info | | `AGENTANY

... View full README on GitHub