Pi इंस्टॉल करणे आणि OmniProxy कॉन्फिगर करणे

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

सब-एजंट्स कामाचा काही भाग दुसऱ्या सहाय्यकाकडे सोपवतात, तर प्लॅन मोड अंमलबजावणी सुरू होण्यापूर्वी पायऱ्यांचे नियोजन करतो. दोन्ही वैशिष्ट्ये डीफॉल्टनुसार समाविष्ट नाहीत, परंतु तुम्ही Pi ला ती तयार करण्यास सांगू शकता किंवा इतरांनी शेअर केलेले पॅकेजेस इंस्टॉल करू शकता.

सुरुवात करण्यापूर्वी

macOS आणि Linux एक इन्स्टॉलेशन स्क्रिप्ट वापरतात—जी एकच कमांड आहे जी आपोआप Pi डाउनलोड आणि इंस्टॉल करते. Windows वर, Pi च्या होमपेजवर दिलेली PowerShell कमांड वापरा. PowerShell हे Windows मध्ये समाविष्ट असलेले कमांड-लाइन वातावरण आहे. तुम्ही Windows मधील Linux वातावरण असलेल्या WSL मध्येही Pi इंस्टॉल करू शकता.

जर तुम्ही 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

इन्स्टॉलेशन स्क्रिप्ट इंटरएक्टिव्ह टर्मिनलमध्ये प्रश्न विचारण्यासाठी थांबू शकते. पुढे जाण्यासाठी स्क्रीनवरील सूचनांचे पालन करा. जर तुमच्याकडे आधीच सुसंगत आवृत्ती असेल, तर ही 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 इंस्टॉल करा.

पुढे, ज्या फोल्डरची तपासणी करायची आहे किंवा ज्यावर काम करायचे आहे त्या फोल्डरमध्ये जा आणि नंतर ते सुरू करा:

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 फॉरमॅट वापरावे.

पूर्ण मॉडेल आयडी कॉपी करा, नावातील कोणत्याही स्लॅशसह. 2026-10-09 रोजी, प्रदाता दस्तऐवजीकरणातील दोन संदर्भ आयडी होते 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 मॉडेल सूचीमधील पूर्ण मॉडेल आयडीशी जुळणे आवश्यक आहे. 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 व्हेरिएबलचा संदर्भ घेऊ शकते
• मॉडेल आयडी अचूक असणे आवश्यक आहे

निवडा

/model

• ते उघडल्याने फाइल पुन्हा लोड होते
• तुम्ही नुकतेच जोडलेले मॉडेल निवडा
• Ctrl+S ते डीफॉल्ट म्हणून सेव्ह करते

वास्तविक कार्यासह सत्यापित करा

कॉन्फिगरेशन पूर्ण केल्यानंतर, तुम्ही फाइल्स असलेल्या डिरेक्टरीमध्ये नॉन-इंटरएक्टिव्ह तपासणी करू शकता. नॉन-इंटरएक्टिव्ह मोडचा अर्थ असा आहे की Pi हे एकच कार्य पूर्ण करते आणि नंतर चालू संभाषणात प्रवेश करण्याऐवजी बाहेर पडते. नंतरचे मूल्य बदला --model सध्याच्या OmniProxy सूचीमधील पूर्ण आयडीसह:

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 च्या विनंती लॉगमध्ये स्त्रोत आणि मॉडेल आयडीची पुष्टी करा.

लाँच करा

pi लाँच होते

• प्रथम फोल्डरमध्ये cd करा
• pi --version आउटपुट तयार करते
• मॉडेलचे नाव इंटरफेसच्या तळाशी दिसते

कार्य

त्याने डिरेक्टरी वाचली

• रिपॉझिटरी कशी आयोजित केली आहे ते विचारा
• त्याच्या यादीतील फाइल्सचे पुनरावलोकन करा
• केवळ यशस्वी कॉन्फिगरेशन सेव्हवर अवलंबून राहू नका

लॉग्स

गेटवेमध्ये दृश्यमान

• स्त्रोत Pi आहे
• मॉडेल आयडी जुळतो
• की स्थानिक मशीनवर ठेवा

सामान्य त्रुटी

• 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. केवळ सेवा स्वतःला सुसंगत असल्याचे वर्णन करते म्हणून अतिरिक्त सुसंगतता पर्याय सक्षम करू नका.
• मॉडेल आयडी अवैध आहे: सध्याच्या OmniProxy सूचीमधून तो पुन्हा कॉपी करा.

अधिकृत संदर्भ

इन्स्टॉलेशन कमांड्ससाठी, पहा Pi वेबसाइट आणि क्विकस्टार्ट. मॉडेल फाइलसाठी, पहा मॉडेल निवडा आणि कॉन्फिगरेशन. Windows कमांड वातावरणासाठी, पहा Windows वर Pi चालवा. उदाहरणांमध्ये वापरलेल्या मॉडेल आयडीसाठी, पहा Gemini मॉडेल सूची आणि xAI मॉडेल्स पृष्ठ.

तुमच्या स्वतःच्या OmniProxy कॉन्फिगरेशनमधील प्रत्येक जागादार मूल्य बदला. वास्तविक की कधीही प्रकाशित करू नका.

संवर्धित परिणाम किंवा HTTP 200 फक्त पूर्ण एजंट सुसंगतता सिद्ध करत नाही. OmniProxy च्या कॉल रेकॉर्डमध्ये स्रोत आणि मॉडेल तपासा.

अधिकृत स्रोत · Pi ↗