Pilot Protocol retire la plateforme du chemin des données. Un service de **rendezvous** léger gère la découverte et la traversée NAT, mais une fois que les agents se trouvent, ils communiquent directement via des tunnels authentifiés et chiffrés :```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

Une fois que vous avez un pair de confiance, la messagerie agent-à-agent utilise le service d'échange de données sur le 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>

Chaque commande CLI prend en charge `--json` pour une sortie structurée — voir la [référence CLI](https://pilotprotocol.network/docs/cli-reference) pour l'ensemble des fonctionnalités.

<details>
<summary><strong>Exemple de sortie JSON</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\""}

Consultez le README de chaque SDK pour la documentation complète de l'API, les exemples de streaming et la configuration spécifique à la plateforme (simulateur iOS, extras PyPI, etc.).

## Points forts

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

**Adressage**
- Adresses virtuelles 48 bits (`N:NNNN.HHHH.LLLL`)
- Ports 16 bits avec assignments bien connus
- Découverte basée sur les noms d'hôte

**Transport**
- Flux fiables (équivalent TCP)
- Fenêtre glissante, SACK, contrôle de congestion (AIMD)
- Contrôle de flux (fenêtre de réception annoncée)
- Fusion Nagle, segmentation automatique, sondage de fenêtre nulle
- Traversée NAT : découverte STUN, hole-punching, repli par relais

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

**Sécurité**
- Échange de clés authentifié (X25519 signé Ed25519 + AES-256-GCM)
- Clés d'identité Ed25519 liées aux sessions de tunnel
- Les nœuds sont privés par défaut
- Protocole de poignée de main de confiance mutuelle (signé, relais via le registre)

**Opérations**
- Protocole central : bibliothèque standard Go uniquement
- Binaire démon unique avec services intégrés
- Journalisation structurée JSON (`slog`)
- Persistance atomique pour tout l'état
- Réplication du registre en veille active

</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

Vous pouvez également ping et benchmark :```bash
pilotctl ping agent-alpha
pilotctl bench agent-alpha

Définir un nom d'hôte et un email lors de l'installation :```bash
curl -fsSL https://pilotprotocol.network/install.sh | [email protected] PILOT_HOSTNAME=my-agent sh

Apps are signed (ed25519), verified at install and at every spawn. The daemon brokers all inter-app calls — an app can only be reached through the methods it declares in its manifest. See the [App Store docs](https://pilotprotocol.network/docs/app-store) for building, signing, and publishing apps.

---

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

Défini dans `~/.pilot/config.json`. Le client de télémétrie devient un no-op strict — pas de dial, pas de goroutine. Prend effet immédiatement pour les commandes CLI.

**Qui devrait se désinscrire :** Les utilisateurs avec des politiques strictes de non-télémétrie, des déploiements à haute sensibilité, ou des pipelines automatisés où toute télémétrie sortante est indésirable.

---

### Broadcasts — risque : moyen

**Ce que ça fait.** Les administrateurs réseau peuvent envoyer un datagramme authentifié unique à tous les agents d'un réseau simultanément. Votre démon vérifie le jeton administrateur et transmet la charge utile à votre agent.

**À qui ça profite.** Les opérateurs de flotte coordonnent tous les agents en une seule commande — rafraîchissements de configuration, redémarrages progressifs, réponse aux incidents — sans O(N) messages individuels. Le seul mécanisme de coordination O(1) dans un grand maillage pair à pair.

**Ce que vous acceptez.** Toute partie détenant le jeton administrateur du réseau peut livrer des données arbitraires à votre agent. La sécurité du jeton est la limite : s'il est divulgué ou détenu par quelqu'un en qui vous n'avez pas confiance, un attaquant peut atteindre votre agent.

**Pour se désinscrire :**```json
{"consent": {"broadcasts": false}}

**Pour se désinscrire :**```json
{"consent": {"reviews": false}}

Le mode est stocké dans `~/.pilot/config.json` sous `skill_inject.mode`. Les modifications prennent effet immédiatement — aucun redémarrage nécessaire.

Tout ce qui est injecté est open source : [`pilot-protocol/skillinject`](https://github.com/pilot-protocol/skillinject) (l'injecteur), [`TeoSlayer/pilot-skills`](https://github.com/TeoSlayer/pilot-skills) (le contenu).

**Qui devrait se désinscrire ou utiliser `manual` :** Les utilisateurs ayant des exigences strictes de contrôle de configuration des agents. Les utilisateurs dans des environnements où toute écriture externe dans les répertoires de configuration pose un problème de conformité.

---

### Mode sandbox du démon

Le démon `pilotd` accepte un drapeau `-sandbox` qui confine tout accès au système de fichiers à un seul répertoire. Ce n'est pas une fonctionnalité de confidentialité — cela ne modifie pas les données envoyées — mais cela limite le rayon d'explosion si le démon est compromis.```bash
pilotd -sandbox                         # confine to ~/.pilot (default)
pilotd -sandbox -sandbox-dir /opt/pilot # confine to a custom directory

Définissez dans `~/.pilot/config.json` et redémarrez le démon. La mise en réseau principale n'est pas affectée.

---

## Variables d'environnement clés

La plupart des flags du démon ont un équivalent en variable d'environnement. Utile pour les déploiements conteneurisés et l'IC.

| Variable | Équivalent flag | Objectif |
|----------|----------------|---------|
| `PILOT_REGISTRY` | `-registry` | Adresse du serveur de registre |
| `PILOT_BEACON` | `-beacon` | Adresse du serveur de balise |
| `PILOT_SOCKET` | `-socket` | Chemin du socket Unix |
| `PILOT_EMAIL` | `-email` | Email du compte |
| `PILOT_HOSTNAME` | `-hostname` | Nom d'hôte de découverte |
| `PILOT_ADMIN_TOKEN` | `-admin-token` | Jeton d'administration pour les opérations réseau |
| `PILOT_MOTD_URL` | `-motd-feed-url` | URL du flux du message du jour |
| `PILOT_TELEMETRY_URL` | `-telemetry-url` | Remplacement du point de terminaison de télémétrie |
| `PILOT_SYN_WHITELIST` | `-syn-whitelist` | Nœuds exemptés de la limite de débit SYN |
| `PILOT_REPLY_WHITELIST` | `-reply-whitelist` | Nœuds exemptés de la limite de débit de réponse |
| `PILOT_REKEY_WHITELIST` | `-rekey-whitelist` | Nœuds exemptés de la limite de débit rekey |
| `PILOT_FLAG_<NAME>` | — | Remplacement du flag de fonctionnalité (`true`/`false`) |
| `PILOT_APP_UPDATE_OPT_OUT` | — | Refus des mises à jour automatiques de l'**app-store**. Définir à `true` et le `pilot-updater` arrête de vérifier et d'installer les mises à jour des applications — les applications installées restent à leur version actuelle. Non défini ou `false` (par défaut) maintient les mises à jour automatiques des applications actives. Les mises à jour des binaires du démon/CLI de Pilot ne sont pas affectées. Lu par `pilot-updater` au démarrage, donc définissez-le dans l'environnement de service du programme de mise à jour et redémarrez le programme de mise à jour pour le modifier. (Alias hérité : `PILOT_UPDATER_NO_APP_UPGRADE`.) |

---

## Documentation

| Document | Description |
|----------|-------------|
| **[Docs Site](https://pilotprotocol.network/docs/)** | Guides, référence CLI, déploiement, configuration et modèles d'intégration |
| **[Wire Specification](https://github.com/pilot-protocol/docs/blob/main/SPEC.md)** | Format de paquet, adressage, flags, sommes de contrôle |
| **[Whitepaper (PDF)](https://github.com/pilot-protocol/docs/blob/main/WHITEPAPER.pdf)** | Conception complète du protocole, transport, sécurité, validation |
| **[IETF Problem Statement](https://www.ietf.org/archive/id/draft-teodor-pilot-problem-statement-01.html)** | Internet-Draft : pourquoi les agents ont besoin d'une infrastructure de couche réseau |
| **[IETF Protocol Specification](https://www.ietf.org/archive/id/draft-teodor-pilot-protocol-01.html)** | Internet-Draft : spécification complète du protocole au format IETF |
| **[Agent Skills](https://github.com/TeoSlayer/pilot-skills)** | Catalogue de compétences d'agent installable pour Pilot Protocol |
| **[Polo Dashboard](https://polo.pilotprotocol.network)** | Statistiques réseau en direct, répertoire de nœuds et recherche par étiquette |
| **[Contributing](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CONTRIBUTING.md)** | Directives pour contribuer au projet |
| **[Governance](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/GOVERNANCE.md)** | Mainteneurs, prise de décision et gestion du projet |
| **[Security Policy](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/SECURITY.md)** | Comment signaler des vulnérabilités |
| **[Third-Party Licenses](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/THIRD_PARTY_LICENSES.md)** | Attribution pour le code tiers |
| **[Changelog](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CHANGELOG.md)** | Historique des versions |
| **[Node.js SDK](https://github.com/pilot-protocol/sdk-node)** | Démarrage rapide : `npm install pilotprotocol` — Liaisons TypeScript via koffi FFI |
| **[Python SDK](https://github.com/pilot-protocol/sdk-python)** | Démarrage rapide : `pip install pilotprotocol` — Liaisons ctypes via libpilot |
| **[Swift SDK](https://github.com/pilot-protocol/sdk-swift)** | Démarrage rapide : dépendance `Package.swift` — iOS/macOS via libpilot.xcframework |

---

## Contact

Des questions, vous voulez un réseau privé ou vous êtes intéressé par un support entreprise ?

- **Email:** [[email protected]](mailto:[email protected])

---

## Licence

Pilot Protocol est sous licence [GNU Affero General Public License v3.0](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/LICENSE).

---

<p align="center">
  <br>
  <a href="https://pilotprotocol.network">
    <strong>Pilot Protocol</strong>
  </a>
  <br>
  <sub>Construit pour les agents, par les humains.</sub>
</p>