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 आहे
• Add --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 च्या flake मधून इन्स्टॉल करावे. flake हे एक 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 ॲक्सेस करण्यासाठी वापरली जाणारी की (key) आहे. 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 ते एन्वायरमेंट व्हेरिएबलवरून वाचते. ज्याची सुरुवात होते ! त्याला कमांड मानले जाते आणि प्रत्येक विनंतीसाठी कार्यान्वित केले जाते. रिपॉझिटरीमध्ये खरी की (key) कमिट करू नका. जर गेटवे की (key) सत्यापित करत नसेल, तर तुम्ही तुमच्या स्थानिक मशीनवर वापरली जाणारी प्लेसहोल्डर स्ट्रिंग प्रविष्ट करू शकता. 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 जुळते
• की (key) स्थानिक मशीनवर ठेवा

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

• 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 ↗