Pi इंस्टॉल करना और OmniProxy कॉन्फ़िगर करना

Pi एक छोटा टर्मिनल असिस्टेंट है—एक प्रोग्राम जो कमांड लाइन में सीधे आपसे बात करता है, फ़ाइलें पढ़ता है, और कार्य पूरा करता है। इसमें एक छोटा सिस्टम प्रॉम्प्ट है और डिफ़ॉल्ट रूप से केवल कुछ टूल हैं। यदि आपको अन्य कमांड, वर्कफ़्लो या इंटरफ़ेस की आवश्यकता है, तो आप उन्हें बाद में एक्सटेंशन के माध्यम से जोड़ सकते हैं। एक्सटेंशन ऐसे घटक हैं जो Pi में क्षमताएं जोड़ते हैं, और आप उन्हें बनाने के बाद दूसरों के साथ साझा कर सकते हैं।

सब-एजेंट किसी कार्य का हिस्सा किसी अन्य असिस्टेंट को सौंपते हैं, जबकि प्लान मोड निष्पादन शुरू होने से पहले चरणों को व्यवस्थित करता है। कोई भी सुविधा डिफ़ॉल्ट रूप से शामिल नहीं है, लेकिन आप Pi को उन्हें बनाने के लिए कह सकते हैं या दूसरों द्वारा साझा किए गए पैकेज इंस्टॉल कर सकते हैं।

शुरू करने से पहले

macOS और Linux एक इंस्टॉलेशन स्क्रिप्ट का उपयोग करते हैं—एक एकल कमांड जो स्वचालित रूप से Pi को डाउनलोड और इंस्टॉल करती है। Windows पर, Pi होमपेज पर प्रदान की गई PowerShell कमांड का उपयोग करें। PowerShell Windows के साथ शामिल कमांड-लाइन एनवायरनमेंट है। आप Pi को WSL में भी इंस्टॉल कर सकते हैं, जो Windows के भीतर उपलब्ध Linux एनवायरनमेंट है।

यदि आप npm के साथ इंस्टॉल करना चुनते हैं, तो आपको Node.js 22.19 या बाद के वर्ज़न की आवश्यकता है। npm Node.js के साथ उपयोग किया जाने वाला पैकेज मैनेजर है और कमांड लाइन से Pi को इंस्टॉल कर सकता है।

macOS Linux

install.sh

• आधिकारिक स्क्रिप्ट को curl करें
• इंस्टॉलर निर्भरताओं को पिन करता है
• pi update के साथ अपडेट करें

Windows

install.ps1

• आधिकारिक PowerShell कमांड
• Git for Windows Bash प्रदान करता है
• आप WSL का भी उपयोग कर सकते हैं

Node पहले से इंस्टॉल है

npm

• Node 22.19+ की आवश्यकता है
• पैकेज का नाम pi-coding-agent है
• --ignore-scripts जोड़ें

पहली बार Pi इंस्टॉल और लॉन्च करें

macOS या Linux पर, एक टर्मिनल खोलें और चलाएं:

curl -fsSL https://pi.dev/install.sh | sh

Windows पर, PowerShell खोलें और चलाएं:

powershell -c "irm https://pi.dev/install.ps1 | iex"

यदि Node.js 22.19 या बाद का वर्ज़न पहले से इंस्टॉल है, तो आप क्विकस्टार्ट से वैकल्पिक कमांड का भी उपयोग कर सकते हैं:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

इंस्टॉलेशन स्क्रिप्ट एक इंटरैक्टिव टर्मिनल में प्रश्न पूछने के लिए रुक सकती है। जारी रखने के लिए ऑन-स्क्रीन संकेतों का पालन करें। यदि आपके पास पहले से ही Node का संगत वर्ज़न है, तो यह npm कमांड प्रश्न नहीं पूछेगी। Pi को किसी अन्य डायरेक्टरी में इंस्टॉल करने के लिए, --prefix /your/directoryजोड़ें। 2026-10-09 को, इसने Pi 1.1.0 इंस्टॉल किया।

एक सामान्य npm इंस्टॉलेशन को डिपेंडेंसी लाइफसाइकिल स्क्रिप्ट की आवश्यकता नहीं होती है, जो ऐसी स्क्रिप्ट हैं जिन्हें पैकेज इंस्टॉलेशन के दौरान स्वचालित रूप से चलाते हैं। इंस्टॉलेशन स्क्रिप्ट निर्भरताओं को पिन करती है; उसके बाद, Pi को pi updateके साथ अपडेट करें। npm इंस्टॉलेशन के लिए, अपने पैकेज मैनेजर द्वारा प्रदान की गई अपडेट विधि का उपयोग करें। Nix उपयोगकर्ताओं को Pi के फ्लेक से इंस्टॉल करना चाहिए। एक फ्लेक एक Nix कॉन्फ़िगरेशन है जो सॉफ़्टवेयर और उसकी निर्भरताओं का वर्णन करता है, और pi update Nix इंस्टॉलेशन को अपडेट नहीं कर सकता है।

इंस्टॉलेशन के बाद, पहले पुष्टि करें कि आपका टर्मिनल Pi को ढूंढ सकता है:

pi --version

Windows पर, यदि आप चाहते हैं कि मॉडल Bash कमांड निष्पादित करें, तो अधिकांश स्थानीय उपयोगकर्ताओं के लिए Git for Windows इंस्टॉल करने की अनुशंसा की जाती है। Bash वह कमांड एनवायरनमेंट है जिसका उपयोग Pi कुछ कमांड चलाने के लिए करता है। Pi shellPath सेटिंग की जांच ~/.pi/agent/settings.jsonमें, Program Files के तहत Git Bash, और फिर bash.exe को PATH पर, उस क्रम में करता है। shellPath Bash के स्थान को निर्दिष्ट करता है, जबकि PATH उन डायरेक्टरी की सूची है जिन्हें सिस्टम कमांड के लिए खोजता है।

Pi शुरू करने के बाद, आप इसे जांचने के लिए !printf 'Bash is working\n' दर्ज कर सकते हैं। यदि आपकी फ़ाइलें और टूल पहले से ही WSL में हैं, तो क्विकस्टार्ट का पालन करके उस Linux एनवायरनमेंट में Pi इंस्टॉल करें।

इसके बाद, उस फ़ोल्डर को दर्ज करें जिसका आप Pi से निरीक्षण या काम करवाना चाहते हैं, और फिर इसे शुरू करें:

cd /path/to/folder
pi

यह फ़ोल्डर Pi का वर्तमान कार्य क्षेत्र बन जाता है। Pi इसका उपयोग फ़ाइलों और कॉन्फ़िगरेशन को खोजने और सत्रों को समूहित करने के लिए करता है।

OmniProxy से कनेक्शन मान प्राप्त करें

पहले, OmniProxy से ये तीन मान प्राप्त करें:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy the full ID from the current OmniProxy model list

baseUrl API एंडपॉइंट है जिस पर Pi अनुरोध भेजता है, और इसमें /v1 शामिल होना चाहिए। apiKey API तक पहुँचने के लिए उपयोग की जाने वाली कुंजी है। Model ID कॉल किए जाने वाले मॉडल का नाम है और इसे वर्तमान OmniProxy मॉडल सूची से पूर्ण रूप से कॉपी किया जाना चाहिए। api को openai-completionsपर सेट करें, जैसा कि संगत API उदाहरण में दिखाया गया है। यह फ़ील्ड Pi को बताती है कि अनुरोध भेजते समय किस API प्रारूप का उपयोग करना है।

पूरी मॉडल ID कॉपी करें, जिसमें नाम में कोई भी स्लैश शामिल है। 2026-10-09 को, प्रदाता दस्तावेज़ीकरण में दो संदर्भ ID gemini-3.8-flash और grok-4.7थे। ऐसा नाम कॉपी न करें जो सूची में मौजूद नहीं है।

टूल कॉन्फ़िगरेशन दर्ज करें

Pi का उपयोगकर्ता-स्तरीय कस्टम मॉडल कॉन्फ़िगरेशन models.jsonमें संग्रहीत है। यह फ़ाइल एजेंट डायरेक्टरी में स्थित है, जो डिफ़ॉल्ट रूप से ~/.pi/agentहै, इसलिए इसका पूर्ण पथ ~/.pi/agent/models.jsonहै। यदि PI_CODING_AGENT_DIR एनवायरनमेंट वेरिएबल सेट है, तो Pi इसके बजाय उस वेरिएबल द्वारा निर्दिष्ट डायरेक्टरी का उपयोग करता है। एक एनवायरनमेंट वेरिएबल सिस्टम द्वारा प्रोग्रामों के पढ़ने के लिए प्रदान किया गया एक कॉन्फ़िगरेशन मान है।

कॉन्फ़िगरेशन को संगत API उदाहरण में दिखाए अनुसार दर्ज करें:

{
  "providers": {
    "omniproxy": {
      "baseUrl": "https://your-omniproxy-origin.example/v1",
      "api": "openai-completions",
      "apiKey": "<YOUR_OMNIPROXY_API_KEY>",
      "models": [
        { "id": "gemini-3.8-flash", "input": ["text"] },
        { "id": "grok-4.7", "input": ["text"] }
      ]
    }
  }
}

providers कनेक्टेड सेवाओं को सूचीबद्ध करता है, जबकि models उन मॉडलों को सूचीबद्ध करता है जिन्हें चुना जा सकता है। प्रत्येक मॉडल का id वर्तमान OmniProxy मॉडल सूची में पूर्ण मॉडल ID से मेल खाना चाहिए। input इंगित करता है कि मॉडल को यहाँ टेक्स्ट इनपुट के लिए कॉन्फ़िगर किया गया है।

apiKey को एक शाब्दिक मान के रूप में दर्ज किया जा सकता है, या $NAME या ${NAME} के रूप में ताकि Pi इसे एक एनवायरनमेंट वेरिएबल से पढ़ सके। ! से शुरू होने वाले मान को एक कमांड के रूप में माना जाता है और प्रत्येक अनुरोध के लिए निष्पादित किया जाता है। किसी रिपॉजिटरी में वास्तविक कुंजी कमिट न करें। यदि गेटवे कुंजियों को मान्य नहीं करता है, तो आप केवल अपनी स्थानीय मशीन पर उपयोग की जाने वाली प्लेसहोल्डर स्ट्रिंग दर्ज कर सकते हैं। 2026-10-09 को, Pi ने इस कॉन्फ़िगरेशन के साथ फ़ाइल को सफलतापूर्वक पढ़ा। /model खोलने से यह फ़ाइल पुनः लोड हो जाती है। /model Pi में मॉडलों को देखने और चुनने के लिए इंटरफ़ेस है। कस्टम मॉडल /model में तब तक दिखाई नहीं देते जब तक Pi उनके क्रेडेंशियल को हल नहीं कर लेता। मॉडल चुनने के बाद, इसे नए सत्रों के लिए डिफ़ॉल्ट मॉडल के रूप में सहेजने के लिए Ctrl+S दबाएं।

फ़ाइल

models.json

• डिफ़ॉल्ट डायरेक्टरी: ~/.pi/agent
• providers के अंतर्गत एक प्रविष्टि जोड़ें
• api को completions पर सेट करें

पता

baseUrl

• /v1 शामिल करें
• apiKey एक वेरिएबल को संदर्भित कर सकता है
• मॉडल id सटीक होनी चाहिए

चुनें

/model

• इसे खोलने से फ़ाइल पुनः लोड हो जाती है
• वह मॉडल चुनें जिसे आपने अभी जोड़ा है
• Ctrl+S इसे डिफ़ॉल्ट के रूप में सहेजता है

वास्तविक कार्य के साथ सत्यापित करें

कॉन्फ़िगरेशन पूरा करने के बाद, आप फ़ाइलों वाली डायरेक्टरी में एक नॉन-इंटरैक्टिव जांच कर सकते हैं। नॉन-इंटरैक्टिव मोड का मतलब है कि Pi इस एकल कार्य को पूरा करता है और फिर चल रही बातचीत में प्रवेश करने के बजाय बाहर निकल जाता है। --model के बाद के मान को वर्तमान OmniProxy सूची से पूर्ण ID से बदलें:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Read the first line of the file you specify. Do not modify the file."

यहाँ, --tools read केवल रीड टूल को सक्षम करता है, और कार्य स्पष्ट रूप से Pi को फ़ाइल को संशोधित न करने का निर्देश भी देता है। 2026-10-09 को, Pi 1.1.0 ने फ़ाइल सामग्री को सफलतापूर्वक पढ़ा। पहली प्रतिक्रिया में लगभग दो मिनट लगे।

आप इंटरैक्टिव मोड का भी उपयोग कर सकते हैं: डायरेक्टरी दर्ज करें, चलाएं pi, और फिर /modelके साथ एक मॉडल चुनें। क्विकस्टार्ट में एक उदाहरण कार्य Pi से यह समझाने के लिए कहता है कि रिपॉजिटरी कैसे व्यवस्थित है और इसके चेक कैसे चलाएं। देखें कि क्या यह फ़ाइलों को पढ़ता है और व्याख्या प्रदान करता है, फिर OmniProxy के अनुरोध लॉग में स्रोत और मॉडल ID की पुष्टि करें।

लॉन्च

pi लॉन्च होता है

• पहले फ़ोल्डर पर cd करें
• pi --version आउटपुट देता है
• मॉडल का नाम इंटरफ़ेस के नीचे दिखाई देता है

कार्य

इसने डायरेक्टरी पढ़ी

• पूछें कि रिपॉजिटरी कैसे व्यवस्थित है
• उन फ़ाइलों की समीक्षा करें जिन्हें यह सूचीबद्ध करता है
• केवल सफल कॉन्फ़िगरेशन सहेजने पर भरोसा न करें

लॉग

गेटवे में दिखाई देता है

• स्रोत Pi है
• मॉडल ID मेल खाता है
• कुंजी को स्थानीय मशीन पर रखें

सामान्य त्रुटियां

• pi नहीं मिल सकता: टर्मिनल को फिर से खोलें और फिर से pi --version का प्रयास करें। npm इंस्टॉलेशन के लिए, पुष्टि करें कि ग्लोबल बिन डायरेक्टरी PATH पर है।
• कस्टम मॉडल /modelमें दिखाई नहीं देते हैं: पुष्टि करें कि models.json में है ~/.pi/agent/, सत्यापित करें कि apiKey को हल किया जा सकता है, और फिर /modelको फिर से खोलें।
• Windows रिपोर्ट करता है कि Bash नहीं मिल सकता: Git for Windows इंस्टॉल करें, या shellPath में ~/.pi/agent/settings.jsonसेट करें। JSON में बैकस्लैश को दो बार लिखा जाना चाहिए।
• अनुरोध अस्वीकार कर दिया गया है: जांचें कि api है openai-completions और यह कि baseUrl में समाप्त होता है /v1। केवल इसलिए अतिरिक्त संगतता विकल्प सक्षम न करें क्योंकि सेवा स्वयं को संगत बताती है।
• मॉडल ID अमान्य है: इसे वर्तमान OmniProxy सूची से फिर से कॉपी करें।

आधिकारिक संदर्भ

इंस्टॉलेशन कमांड के लिए, Pi website और Quickstart देखें। मॉडल फ़ाइल के लिए, Choose a Model और Configuration देखें। Windows कमांड एनवायरनमेंट के लिए, Run Pi on Windows देखें। उदाहरणों में उपयोग की गई मॉडल ID के लिए, Gemini model list और xAI models page देखें।

अपनी स्वयं की OmniProxy कॉन्फ़िगरेशन से प्रत्येक प्लेसहोल्डर को मान से बदलें। कभी भी एक वास्तविक कुंजी प्रकाशित न करें।

एक सहेजा गया परिणाम या HTTP 200 अकेले पूरी एजेंट संगतता को साबित नहीं करता है। OmniProxy के कॉल रिकॉर्ड में स्रोत और मॉडल जांचें।

आधिकारिक स्रोत · Pi ↗