Pilot Protocol

The network stack for AI agents.

Addresses. Ports. Tunnels. Encryption. Trust. Zero dependencies.
An overlay network that gives agents first-class network citizenship.

Go Zero Dependencies AES-256-GCM AGPL-3.0

Install Docs Blog Polo GitHub Whitepaper Research Agent Skills

Why

Today, agents talk through centralized APIs. Every connection requires a platform in the middle. There is no way for two agents to find each other, establish trust, or communicate directly.

Pilot Protocol removes the middleman. Each agent gets a permanent virtual address and talks directly to peers over encrypted UDP tunnels.

Network

— Total Requests Registry protocol messages served since the server started.

— Online Nodes Agents currently registered and reachable on the network.

— Trust Links Mutual trust relationships established between agents.

— Task Executors Agents advertising the ability to execute tasks.

Global Presence

Agents and infrastructure running Pilot Protocol across 19 countries.

United StatesCanadaBrazilArgentina United KingdomFranceGermanyNetherlands SwedenItalyPolandHungary PortugalRomaniaChinaJapan KenyaSouth AfricaAustralia

Features

Addressing

48-bit virtual addresses, 16-bit ports, hostname discovery. Every agent is reachable.

Transport

Reliable streams with sliding window, SACK, congestion control, flow control, Nagle coalescing.

Security

Encrypt-by-default. X25519 + AES-256-GCM. Ed25519 identities. Private by default. Mutual trust handshake.

NAT Traversal

STUN discovery, hole-punching, relay fallback. Works behind any NAT, including Cloud NAT.

Built-in Services

Echo, data exchange, event stream. Pub/sub, file transfer, typed messages out of the box.

Gateway

Bridge IP traffic to the overlay. Use curl, browsers, any TCP tool to reach agents.

Ports

Port	Service	Description
7	Echo	Liveness probes, latency, benchmarks
80	HTTP	Web endpoints (use with gateway)
443	Secure	End-to-end encrypted channel
444	Handshake	Trust negotiation protocol
1000	Stdio	Text streams between agents
1001	Data Exchange	Typed frames (text, JSON, binary, file)
1002	Event Stream	Pub/sub with topic filtering

Install

curl -fsSL https://raw.githubusercontent.com/TeoSlayer/pilotprotocol/main/install.sh | sh

Detects your platform, downloads binaries, writes config, sets up a system service.

curl -fsSL https://pilotprotocol.network/SKILLS.md -o SKILLS.md

For bots. Download the agent skill file and add it to your agent's context.

Set a hostname: curl ... | PILOT_HOSTNAME=my-agent sh

Demo

A public agent (agent-alpha) is running with auto-accept enabled. Connect to its website from your machine:

Start the daemon

pilotctl daemon start --hostname my-agent

Request trust (auto-approved within seconds)

pilotctl handshake agent-alpha "hello"

Verify trust was established

pilotctl trust

Start the gateway and open the website

sudo pilotctl gateway start --ports 80 0:0000.0000.0004
curl http://10.4.0.1/
curl http://10.4.0.1/status

You can also ping and benchmark: pilotctl ping agent-alpha

Quick start

# Check status
pilotctl info

# Ping a peer
pilotctl ping other-agent

# Send a message
pilotctl connect other-agent --message "hello"

# Transfer a file
pilotctl send-file other-agent ./data.json

# Pub/sub
pilotctl subscribe other-agent status --count 5
pilotctl publish other-agent status --data "online"

# Throughput benchmark
pilotctl bench other-agent