Pilot Protocol nimmt die Plattform aus dem Datenpfad. Ein leichtgewichtiger **Rendezvous**-Dienst übernimmt die Erkennung und NAT-Traversal, sobald sich die Agenten jedoch gefunden haben, kommunizieren sie direkt über authentifizierte, verschlüsselte Tunnel:```mermaid
graph LR
    A1[Agent A<br/><small>0:0000.0000.0001</small>] <-->|Encrypted UDP Tunnel| A2[Agent B<br/><small>0:0000.0000.0002</small>]
    A1 <-->|Encrypted UDP Tunnel| A3[Agent C<br/><small>0:0000.0000.0003</small>]
    A2 <-->|Encrypted UDP Tunnel| A3
    A1 -.->|discovery| RV[Rendezvous]
    A2 -.->|discovery| RV
    A3 -.->|discovery| RV
    style A1 fill:#4a9,stroke:#333,color:#fff
    style A2 fill:#4a9,stroke:#333,color:#fff
    style A3 fill:#4a9,stroke:#333,color:#fff
    style RV fill:#888,stroke:#333,color:#fff

Sobald Sie einen vertrauenswürdigen Peer haben, nutzt die Agent-zu-Agent-Kommunikation den Datenaustauschdienst auf Port 1001:```bash
# Send a structured message (waits for reply by default)
pilotctl send-message other-agent --data "hello"

# Read messages delivered to your inbox
pilotctl inbox

# Read a specific message
pilotctl inbox read <id>

Jeder CLI-Befehl unterstützt `--json` für strukturierte Ausgabe — siehe die [CLI-Referenz](https://pilotprotocol.network/docs/cli-reference) für den gesamten Funktionsumfang.

<details>
<summary><strong>Beispiel JSON-Ausgabe</strong></summary>```json
$ pilotctl --json info
{"status":"ok","data":{"address":"0:0000.0000.0005","node_id":5,"hostname":"my-agent","peers":3,"connections":1,"uptime_secs":3600}}

$ pilotctl --json find other-agent
{"status":"ok","data":{"hostname":"other-agent","address":"0:0000.0000.0003"}}

$ pilotctl --json recv 1000 --count 1
{"status":"ok","data":{"messages":[{"seq":0,"port":1000,"data":"hello","bytes":5}]}}

$ pilotctl --json find nonexistent
{"status":"error","code":"not_found","message":"cannot find \"nonexistent\" — hostname not found or no mutual trust","hint":"establish trust first: pilotctl handshake nonexistent \"reason\""}

Siehe die README jedes SDKs für die vollständige API-Dokumentation, Streaming-Beispiele und plattformspezifische Einrichtung (iOS Simulator, PyPI-Extras, usw.).

## Highlights

<table>
<tr>
<td width="50%" valign="top">

**Adressierung**
- 48-Bit virtuelle Adressen (`N:NNNN.HHHH.LLLL`)
- 16-Bit-Ports mit bekannten Zuweisungen
- Hostname-basierte Erkennung

**Transport**
- Zuverlässige Streams (TCP-äquivalent)
- Sliding Window, SACK, Überlastkontrolle (AIMD)
- Flusskontrolle (angekündigtes Empfangsfenster)
- Nagle-Coalescing, automatische Segmentierung, Zero-Window-Probing
- NAT-Traversal: STUN-Erkennung, Hole-Punching, Relay-Fallback

</td>
<td width="50%" valign="top">

**Sicherheit**
- Authentifizierter Schlüsselaustausch (Ed25519-signiertes X25519 + AES-256-GCM)
- Ed25519-Identitätsschlüssel an Tunnelsitzungen gebunden
- Knoten sind standardmäßig privat
- Gegenseitiges Vertrauens-Handshake-Protokoll (signiert, Weiterleitung über Registry)

**Betrieb**
- Kernprotokoll: Nur Go-Standardbibliothek
- Einzelnes Daemon-Binary mit integrierten Diensten
- Strukturierte JSON-Protokollierung (`slog`)
- Atomare Persistenz für den gesamten Zustand
- Hot-Standby-Registry-Replikation

</td>
</tr>
</table>

---

## Architecture```mermaid
graph LR
    subgraph Local Machine
        Agent[Your Agent] -->|commands| CLI[pilotctl]
        CLI -->|Unix socket| D[Daemon]
        D --- E[Echo :7]
        D --- DX[Data Exchange :1001]
        D --- ES[Event Stream :1002]
    end

    D <====>|UDP Tunnel<br/>AES-256-GCM + NAT traversal| RD

    subgraph Remote Machine
        RD[Remote Daemon] -->|Unix socket| RC[pilotctl]
        RC -->|commands| RA[Remote Agent]
        RD --- RE[Echo :7]
        RD --- RDX[Data Exchange :1001]
        RD --- RES[Event Stream :1002]
    end

    D -.->|register + discover| RV
    RD -.->|register + discover| RV

    subgraph Rendezvous
        RV[Registry :9000<br/>Beacon :9001]
    end

Sie können auch pingen und benchmarken:```bash
pilotctl ping agent-alpha
pilotctl bench agent-alpha

Legen Sie während der Installation einen Hostnamen und eine E-Mail-Adresse fest:```bash
curl -fsSL https://pilotprotocol.network/install.sh | [email protected] PILOT_HOSTNAME=my-agent sh

Apps sind signiert (ed25519), werden bei der Installation und bei jedem Start überprüft. Der Daemon vermittelt alle app-übergreifenden Aufrufe — eine App kann nur über die Methoden erreicht werden, die sie in ihrem Manifest deklariert. Siehe die [App Store-Dokumentation](https://pilotprotocol.network/docs/app-store) zum Erstellen, Signieren und Veröffentlichen von Apps.

---

## Testen```bash
go test -parallel 4 -count=1 ./tests/

In `~/.pilot/config.json` festgelegt. Der Telemetrie-Client wird zu einem harten No-Op — kein Dial, keine Goroutine. Wirkt sofort für CLI-Befehle.

**Wer sich abmelden sollte:** Benutzer mit strengen No-Telemetrie-Richtlinien, hochsensiblen Bereitstellungen oder automatisierten Pipelines, bei denen ausgehende Telemetrie unerwünscht ist.

---

### Broadcasts — Risiko: mittel

**Was es tut.** Netzwerkadministratoren können ein einzelnes authentifiziertes Datagramm gleichzeitig an jeden Agenten in einem Netzwerk senden. Ihr Daemon überprüft das Admin-Token und leitet die Nutzlast an Ihren Agenten weiter.

**Wem es hilft.** Flottenbetreiber koordinieren alle Agenten mit einem Befehl — Konfigurationsaktualisierungen, rollierende Neustarts, Incident Response — ohne O(N) einzelne Nachrichten. Der einzige O(1)-Koordinationsmechanismus in einem großen Peer-Mesh.

**Was Sie akzeptieren.** Jede Partei, die das Admin-Token des Netzwerks besitzt, kann beliebige Daten an Ihren Agenten liefern. Die Sicherheit des Tokens ist die Grenze: Wenn es durchsickert oder von jemandem gehalten wird, dem Sie nicht vertrauen, kann ein Angreifer Ihren Agenten erreichen.

**So melden Sie sich ab:**```json
{"consent": {"broadcasts": false}}

**Zum Opt-out:**```json
{"consent": {"reviews": false}}

Mode wird in `~/.pilot/config.json` unter `skill_inject.mode` gespeichert. Änderungen werden sofort wirksam — kein Neustart erforderlich.

Alles Injektierte ist Open Source: [`pilot-protocol/skillinject`](https://github.com/pilot-protocol/skillinject) (der Injector), [`TeoSlayer/pilot-skills`](https://github.com/TeoSlayer/pilot-skills) (der Inhalt).

**Wer sollte sich abmelden oder `manual` verwenden:** Benutzer mit strengen Anforderungen an die Agentenkonfigurationskontrolle. Benutzer in Umgebungen, in denen externes Schreiben in Konfigurationsverzeichnisse ein Compliance-Problem darstellt.

---

### Daemon-Sandbox-Modus

Der `pilotd`-Daemon akzeptiert ein `-sandbox`-Flag, das den gesamten Dateisystemzugriff auf ein einzelnes Verzeichnis beschränkt. Dies ist keine Datenschutzfunktion — es ändert nicht, welche Daten gesendet werden —, aber es begrenzt die Schadensreichweite, falls der Daemon kompromittiert wird.```bash
pilotd -sandbox                         # confine to ~/.pilot (default)
pilotd -sandbox -sandbox-dir /opt/pilot # confine to a custom directory

Setzen Sie dies in `~/.pilot/config.json` fest und starten Sie den Daemon neu. Das Kernnetzwerk bleibt unberührt.

---

## Wichtige Umgebungsvariablen

Die meisten Daemon-Flags haben ein entsprechendes Umgebungsvariable. Nützlich für containerisierte Bereitstellungen und CI.

| Variable | Flag-Äquivalent | Zweck |
|----------|----------------|---------|
| `PILOT_REGISTRY` | `-registry` | Adresse des Registrierungsservers |
| `PILOT_BEACON` | `-beacon` | Adresse des Beacon-Servers |
| `PILOT_SOCKET` | `-socket` | Unix-Socket-Pfad |
| `PILOT_EMAIL` | `-email` | Konto-E-Mail |
| `PILOT_HOSTNAME` | `-hostname` | Discovery-Hostname |
| `PILOT_ADMIN_TOKEN` | `-admin-token` | Admin-Token für Netzwerkoperationen |
| `PILOT_MOTD_URL` | `-motd-feed-url` | Feed-URL der Nachricht des Tages |
| `PILOT_TELEMETRY_URL` | `-telemetry-url` | Telemetrie-Endpunkt-Überschreibung |
| `PILOT_SYN_WHITELIST` | `-syn-whitelist` | Von der SYN-Ratenbegrenzung ausgenommene Knoten |
| `PILOT_REPLY_WHITELIST` | `-reply-whitelist` | Von der Antwort-Ratenbegrenzung ausgenommene Knoten |
| `PILOT_REKEY_WHITELIST` | `-rekey-whitelist` | Von der Wiederschlüsselungs-Ratenbegrenzung ausgenommene Knoten |
| `PILOT_FLAG_<NAME>` | — | Überschreibung von Feature-Flags (`true`/`false`) |
| `PILOT_APP_UPDATE_OPT_OUT` | — | Deaktivieren Sie automatische **App-Store**-Updates. Wenn auf `true` gesetzt, hört der `pilot-updater` auf, nach App-Updates zu suchen und diese zu installieren – installierte Apps bleiben in ihrer aktuellen Version. Wenn nicht gesetzt oder auf `false` (Standard) gesetzt, bleiben automatische App-Updates aktiv. Updates des Pilot-Daemon/CLI-Binaries sind nicht betroffen. Wird vom `pilot-updater` beim Start gelesen, also setzen Sie es in der Service-Umgebung des Updaters und starten Sie den Updater neu, um es zu ändern. (Legacy-Alias: `PILOT_UPDATER_NO_APP_UPGRADE`.) |

---

## Dokumentation

| Dokument | Beschreibung |
|----------|-------------|
| **[Docs Site](https://pilotprotocol.network/docs/)** | Anleitungen, CLI-Referenz, Bereitstellung, Konfiguration und Integrationsmuster |
| **[Wire Specification](https://github.com/pilot-protocol/docs/blob/main/SPEC.md)** | Paketformat, Adressierung, Flags, Prüfsummen |
| **[Whitepaper (PDF)](https://github.com/pilot-protocol/docs/blob/main/WHITEPAPER.pdf)** | Vollständiges Protokoll-Design, Transport, Sicherheit, Validierung |
| **[IETF Problem Statement](https://www.ietf.org/archive/id/draft-teodor-pilot-problem-statement-01.html)** | Internet-Entwurf: Warum Agents netzwerkschichtige Infrastruktur benötigen |
| **[IETF Protocol Specification](https://www.ietf.org/archive/id/draft-teodor-pilot-protocol-01.html)** | Internet-Entwurf: vollständige Protokollspezifikation im IETF-Format |
| **[Agent Skills](https://github.com/TeoSlayer/pilot-skills)** | Installierbarer Katalog von Agentenfähigkeiten für das Pilot-Protokoll |
| **[Polo Dashboard](https://polo.pilotprotocol.network)** | Live-Netzwerkstatistiken, Knotenverzeichnis und Tagsuche |
| **[Contributing](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CONTRIBUTING.md)** | Richtlinien für Beiträge zum Projekt |
| **[Governance](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/GOVERNANCE.md)** | Betreuer, Entscheidungsfindung und Projektverwaltung |
| **[Security Policy](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/SECURITY.md)** | So melden Sie Sicherheitslücken |
| **[Third-Party Licenses](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/THIRD_PARTY_LICENSES.md)** | Namensnennung für Drittanbieter-Code |
| **[Changelog](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CHANGELOG.md)** | Versionsverlauf |
| **[Node.js SDK](https://github.com/pilot-protocol/sdk-node)** | Schnellstart: `npm install pilotprotocol` — TypeScript-Bindungen über koffi FFI |
| **[Python SDK](https://github.com/pilot-protocol/sdk-python)** | Schnellstart: `pip install pilotprotocol` — ctypes-Bindungen über libpilot |
| **[Swift SDK](https://github.com/pilot-protocol/sdk-swift)** | Schnellstart: `Package.swift`-Abhängigkeit — iOS/macOS über libpilot.xcframework |

---

## Kontakt

Haben Sie Fragen, wünschen Sie ein privates Netzwerk oder sind Sie an Enterprise-Support interessiert?

- **E-Mail:** [[email protected]](mailto:[email protected])

---

## Lizenz

Pilot Protocol ist unter der [GNU Affero General Public License v3.0](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/LICENSE) lizenziert.

---

<p align="center">
  <br>
  <a href="https://pilotprotocol.network">
    <strong>Pilot Protocol</strong>
  </a>
  <br>
  <sub>Erstellt für Agents, von Menschen.</sub>
</p>