Pilot Protocol

AI एजेंट्स के लिए नेटवर्क स्टैक।
पते। पोर्ट्स। टनल। एन्क्रिप्शन। भरोसा।

Docs  ·  Wire Spec  ·  Whitepaper  ·  IETF Draft  ·  Agent Skills  ·  Polo (Live Dashboard)

---

इंटरनेट मनुष्यों के लिए बनाया गया था। AI एजेंट्स के पास न कोई पता है, न पहचान, और न ही उन तक पहुँचने का कोई तरीका। Pilot Protocol एक ओवरले नेटवर्क है जो एजेंट्स को वही देता है जो इंटरनेट ने डिवाइसों को दिया था: एक स्थायी पता, प्रमाणित एन्क्रिप्टेड चैनल, और एक ट्रस्ट मॉडल -- यह सब मानक UDP के ऊपर परतों में बना हुआ।

एजेंट्स डिस्कवरी और NAT ट्रैवर्सल के लिए एक रेंडेज़वस सेवा के साथ रजिस्टर करते हैं। एप्लिकेशन डेटा सीधे पाथ पर पीयर्स के बीच सीधे प्रवाहित होता है; जब NAT होल-पंचिंग विफल हो जाती है (जैसे सिमेट्रिक NAT), तो बीकन अभी भी एंड-टू-एंड-एन्क्रिप्टेड ट्रैफ़िक को फ़ॉलबैक के रूप में रिले करता है। यह कोई API नहीं है। यह कोई फ्रेमवर्क नहीं है। यह इन्फ्रास्ट्रक्चर है।

---

समस्या

आज, एजेंट्स केंद्रीकृत APIs के माध्यम से बात करते हैं। हर संदेश एक प्लेटफ़ॉर्म से होकर गुज़रता है -- प्लेटफ़ॉर्म सारा ट्रैफ़िक देखता है, एक्सेस को नियंत्रित करता है, और विफलता का एकल बिंदु बन जाता है।```mermaid graph LR A1[Agent A] -->|HTTP API| P[Platform / Cloud] A2[Agent B] -->|HTTP API| P A3[Agent C] -->|HTTP API| P style P fill:#f66,stroke:#333,color:#fff style A1 fill:#4a9,stroke:#333,color:#fff style A2 fill:#4a9,stroke:#333,color:#fff style A3 fill:#4a9,stroke:#333,color:#fff

Pilot Protocol प्लेटफ़ॉर्म को डेटा पथ से बाहर निकाल देता है। एक हल्की **rendezvous** सेवा डिस्कवरी और NAT traversal को संभालती है, लेकिन एक बार एजेंट्स एक-दूसरे को ढूंढ लेने के बाद, वे सीधे प्रमाणित, एन्क्रिप्टेड टनल के माध्यम से बात करते हैं:```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

एजेंट्स को क्या मिलता है```bash

pilotctl info # show your address, hostname, peer count pilotctl set-hostname my-agent # claim a name other agents can resolve pilotctl find agent-alpha # resolve a public demo peer pilotctl ping agent-alpha # round-trip over the encrypted tunnel pilotctl bench agent-alpha # 1 MB echo benchmark

एक बार जब आपके पास एक विश्वसनीय पीयर हो, तो एजेंट-टू-एजेंट मैसेजिंग पोर्ट 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>

निम्न-स्तरीय कच्चे पोर्ट मैसेजिंग के लिए:```bash

on the sender

pilotctl send other-agent 1000 --data "hello"

on the receiver

pilotctl recv 1000 --count 5 --timeout 30s

हर CLI कमांड संरचित आउटपुट के लिए `--json` का समर्थन करता है — पूर्ण सरफेस एरिया के लिए [CLI संदर्भ](https://pilotprotocol.network/docs/cli-reference) देखें।

<details>
<summary><strong>उदाहरण 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\""}

---

प्रोग्रामेटिक एक्सेस (SDKs)

एक बार डेमन चलने के बाद, आप CLI के बजाय SDK के माध्यम से एजेंट्स के साथ प्रोग्रामेटिक रूप से इंटरैक्ट कर सकते हैं। तीनों SDKs अपने Unix socket IPC के माध्यम से लोकल Pilot डेमन के साथ संचार करते हैं और पूरी एजेंट सतह — handshake, trust, send, receive, stream, और gateway — आपकी पसंद की भाषा में उजागर करते हैं।

भाषा	पैकेज	क्विकस्टार्ट
Node.js / TypeScript	pilotprotocol npm पर	npm install pilotprotocol — देखें sdk-node README
Python	pilotprotocol PyPI पर	pip install pilotprotocol — देखें sdk-python README
Swift / iOS / macOS	pilotprotocol GitHub पर	Package.swift के माध्यम से जोड़ें — देखें sdk-swift README

daemon start के बाद एक न्यूनतम Node.js प्रथम-क्वेरी उदाहरण:```js import { createPilot, createAgent } from 'pilotprotocol';

const pilot = await createPilot(); const conn = await pilot.handshake('agent-alpha', 'hello'); await conn.trust();

// Send a message await conn.send(3000, Buffer.from('ping'));

// Receive on any port const msgs = await conn.recv(3000, { count: 1, timeout: 10 }); console.log('Received:', msgs[0].data.toString());

प्रत्येक SDK के पूर्ण API दस्तावेज़, स्ट्रीमिंग उदाहरण, और प्लेटफ़ॉर्म-विशिष्ट सेटअप (iOS सिम्युलेटर, PyPI एक्स्ट्रा, आदि) के लिए उसका README देखें।

## मुख्य विशेषताएँ

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

**एड्रेसिंग**
- 48-बिट वर्चुअल एड्रेस (`N:NNNN.HHHH.LLLL`)
- सुविख्यात असाइनमेंट के साथ 16-बिट पोर्ट
- होस्टनाम-आधारित डिस्कवरी

**ट्रांसपोर्ट**
- विश्वसनीय स्ट्रीम (TCP-समतुल्य)
- स्लाइडिंग विंडो, SACK, कंजेशन कंट्रोल (AIMD)
- फ़्लो कंट्रोल (विज्ञापित रिसीव विंडो)
- Nagle कोलेसिंग, ऑटो सेगमेंटेशन, ज़ीरो-विंडो प्रोबिंग
- NAT ट्रैवर्सल: STUN डिस्कवरी, होल-पंचिंग, रिले फ़ॉलबैक

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