Kusakinisha Pi na Kusanidi OmniProxy

Pi ni msaidizi mdogo wa terminal—programu inayozungumza nawe moja kwa moja kwenye mstari wa amri, kusoma faili, na kukamilisha kazi. Ina kidokezo kifupi cha mfumo na zana chache tu kwa chaguo-msingi. Ikiwa unahitaji amri nyingine, mitiririko ya kazi, au violesura, unaweza kuongeza baadaye kupitia viendelezi. Viendelezi ni vipengele vinavyoongeza uwezo kwa Pi, na unaweza kuvishiriki na wengine baada ya kuvitengeneza.

Maajenti wadogo (Subagents) hukabidhi sehemu ya kazi kwa msaidizi mwingine, wakati hali ya mpango (plan mode) hupanga hatua kabla ya utekelezaji kuanza. Hakuna kipengele kinachojumuishwa kwa chaguo-msingi, lakini unaweza kumwomba Pi avijenge au kusakinisha vifurushi vilivyoshirikiwa na wengine.

Kabla ya kuanza

macOS na Linux hutumia hati ya usakinishaji—amri moja inayopakua na kusakinisha Pi kiotomatiki. Kwenye Windows, tumia amri ya PowerShell iliyotolewa kwenye ukurasa wa nyumbani wa Pi. PowerShell ni mazingira ya mstari wa amri yaliyojumuishwa na Windows. Unaweza pia kusakinisha Pi kwenye WSL, mazingira ya Linux yanayopatikana ndani ya Windows.

Ikiwa utachagua kusakinisha na npm, unahitaji Node.js 22.19 au toleo jipya zaidi. npm ni kidhibiti cha vifurushi kinachotumiwa na Node.js na kinaweza kusakinisha Pi kutoka kwa mstari wa amri.

macOS Linux

install.sh

curl hati rasmi
Kisakinishi hufunga utegemezi
Sasisha na pi update

Windows

install.ps1

Amri rasmi ya PowerShell
Git for Windows hutoa Bash
Unaweza pia kutumia WSL

Node tayari imesakinishwa

npm

Inahitaji Node 22.19+
Jina la kifurushi ni pi-coding-agent
Ongeza --ignore-scripts

Hati ya usakinishaji hufunga utegemezi. Usakinishaji wa npm haufungi utegemezi wa mpito na unahitaji --ignore-scripts.

Sakinisha na uzindue Pi kwa mara ya kwanza

Kwenye macOS au Linux, fungua terminal na uendeshe:

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

Kwenye Windows, fungua PowerShell na uendeshe:

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

Ikiwa Node.js 22.19 au toleo jipya zaidi tayari limesakinishwa, unaweza pia kutumia amri mbadala kutoka kwa Quickstart:

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

Hati ya usakinishaji inaweza kusitisha ili kuuliza maswali katika terminal ya mwingiliano. Fuata vidokezo kwenye skrini ili kuendelea. Ikiwa tayari una toleo linalooana la Node, amri hii ya npm haitauliza maswali. Ili kusakinisha Pi kwenye saraka nyingine, ongeza --prefix /your/directory. Mnamo 2026-10-09, hii ilisakinisha Pi 1.1.0.

Usakinishaji wa kawaida wa npm hauhitaji hati za mzunguko wa maisha ya utegemezi, ambazo ni hati ambazo vifurushi huendesha kiotomatiki wakati wa usakinishaji. Hati ya usakinishaji hufunga utegemezi; baadaye, sasisha Pi na pi update. Kwa usakinishaji wa npm, tumia njia ya sasisho iliyotolewa na kidhibiti chako cha vifurushi. Watumiaji wa Nix wanapaswa kusakinisha kutoka kwa flake ya Pi. Flake ni usanidi wa Nix unaoelezea programu na utegemezi wake, na pi update haiwezi kusasisha usakinishaji wa Nix.

Baada ya kusakinisha, kwanza thibitisha kuwa terminal yako inaweza kupata Pi:

pi --version

Kwenye Windows, ikiwa unataka miundo itekeleze amri za Bash, kusakinisha Git for Windows kunapendekezwa kwa watumiaji wengi wa ndani. Bash ni mazingira ya amri ambayo Pi hutumia kuendesha amri fulani. Pi hukagua mpangilio wa shellPath katika ~/.pi/agent/settings.json, Git Bash chini ya Program Files, na kisha bash.exe kwenye PATH, kwa mpangilio huo. shellPath hubainisha eneo la Bash, wakati PATH ni orodha ya saraka ambazo mfumo hutafuta amri.

Baada ya kuanza Pi, unaweza kuingiza !printf 'Bash is working\n' ili kuikagua. Ikiwa faili na zana zako tayari ziko kwenye WSL, sakinisha Pi katika mazingira hayo ya Linux kwa kufuata Quickstart.

Kisha, ingiza folda unayotaka Pi ikague au ifanyie kazi, na kisha uianzishe:

cd /path/to/folder
pi

Folda hii inakuwa upeo wa sasa wa kazi wa Pi. Pi huitumia kugundua faili na usanidi na kupanga vikao.

Pata thamani za muunganisho kutoka OmniProxy

Kwanza, pata thamani hizi tatu kutoka 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 ni mwisho wa API ambao Pi hutuma maombi, na lazima ujumuishe /v1. apiKey ni ufunguo unaotumiwa kufikia API. Model ID ni jina la muundo wa kuitwa na lazima linakiliwe kikamilifu kutoka kwa orodha ya sasa ya miundo ya OmniProxy.

Weka api kuwa openai-completions, kama inavyoonyeshwa kwenye mfano wa API unaooana. Sehemu hii humwambia Pi ni umbizo gani la API la kutumia wakati wa kutuma maombi.

Nakili kitambulisho kamili cha muundo, ikijumuisha mikwaju yoyote kwenye jina. Mnamo 2026-10-09, vitambulisho viwili vya marejeleo katika nyaraka za mtoa huduma vilikuwa gemini-3.8-flash na grok-4.7. Usinakili jina ambalo halipo kwenye orodha.

Ingiza usanidi wa zana

Usanidi wa muundo maalum wa kiwango cha mtumiaji wa Pi umehifadhiwa kwenye models.json. Faili hii iko kwenye saraka ya wakala, ambayo ni ~/.pi/agent kwa chaguo-msingi, kwa hivyo njia yake kamili ni ~/.pi/agent/models.json. Ikiwa kigeu cha mazingira cha PI_CODING_AGENT_DIR kimewekwa, Pi hutumia saraka iliyobainishwa na kigeu hicho badala yake. Kigeu cha mazingira ni thamani ya usanidi inayotolewa na mfumo kwa programu kusoma.

Ingiza usanidi kama inavyoonyeshwa kwenye mfano wa API unaooana:

{
  "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 huorodhesha huduma zilizounganishwa, wakati models huorodhesha miundo inayoweza kuchaguliwa. id ya kila muundo lazima ilingane na Kitambulisho kamili cha Muundo katika orodha ya sasa ya miundo ya OmniProxy. input inaonyesha kuwa muundo umesanidiwa hapa kwa ingizo la maandishi.

apiKey inaweza kuingizwa kama thamani ya herufi, au kama $NAME au ${NAME} ili Pi aisome kutoka kwa kigeu cha mazingira. Thamani inayoanza na ! inachukuliwa kama amri na kutekelezwa kwa kila ombi. Usikabidhi ufunguo halisi kwenye hazina. Ikiwa gateway haithibitishi funguo, unaweza kuingiza kamba ya kishika nafasi inayotumiwa kwenye mashine yako ya ndani pekee. Mnamo 2026-10-09, Pi ilisoma faili kwa mafanikio na usanidi huu.

Kufungua /model hupakia upya faili hii. /model ni kiolesura katika Pi cha kutazama na kuchagua miundo. Miundo maalum haionekani kwenye /model hadi Pi iweze kutatua vitambulisho vyake. Baada ya kuchagua muundo, bonyeza Ctrl+S ili kuuhifadhi kama muundo chaguo-msingi kwa vikao vipya.

Faili

models.json

Saraka chaguo-msingi: ~/.pi/agent
Ongeza ingizo chini ya providers
Weka api kuwa completions

Anwani

baseUrl

Jumuisha /v1
apiKey inaweza kurejelea kigeu
Kitambulisho cha muundo lazima kiwe sahihi

Chagua

/model

Kuifungua hupakia upya faili
Chagua muundo uliouongeza hivi punde
Ctrl+S huihifadhi kama chaguo-msingi

Baada ya kuhariri faili, fungua /model katika Pi na uthibitishe kuwa miundo inaonekana.

Thibitisha na kazi halisi

Baada ya kukamilisha usanidi, unaweza kufanya ukaguzi usio wa mwingiliano katika saraka iliyo na faili. Hali isiyo ya mwingiliano inamaanisha Pi hukamilisha kazi hii moja na kisha kutoka badala ya kuingia kwenye mazungumzo yanayoendelea. Badilisha thamani baada ya --model na kitambulisho kamili kutoka kwa orodha ya sasa ya 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."

Hapa, --tools read huwezesha zana ya kusoma pekee, na kazi pia inamwagiza Pi waziwazi kutorekebisha faili. Mnamo 2026-10-09, Pi 1.1.0 ilisoma yaliyomo kwenye faili kwa mafanikio. Jibu la kwanza lilichukua kama dakika mbili.

Unaweza pia kutumia hali ya mwingiliano: ingiza saraka, endesha pi, na kisha chagua muundo na /model. Kazi moja ya mfano katika Quickstart inamwomba Pi aeleze jinsi hazina inavyopangwa na jinsi ya kuendesha ukaguzi wake. Angalia ikiwa anasoma faili na kutoa maelezo, kisha uthibitishe chanzo na kitambulisho cha muundo katika kumbukumbu za ombi za OmniProxy.

Zindua

pi inazindua

Kwanza cd kwenye folda
pi --version hutoa matokeo
Jina la muundo linaonekana chini ya kiolesura

Kazi

Ilisoma saraka

Uliza jinsi hazina inavyopangwa
Kagua faili anazoorodhesha
Usitegemee tu uhifadhi wa usanidi uliofanikiwa

Kumbukumbu

Inaonekana kwenye gateway

Chanzo ni Pi
Kitambulisho cha muundo kinalingana
Weka ufunguo kwenye mashine ya ndani

Baada ya jina la muundo kuonekana chini ya kiolesura, kamilisha kazi moja halisi pia.

Makosa ya kawaida

pi haiwezi kupatikana: Fungua tena terminal na ujaribu pi --version tena. Kwa usakinishaji wa npm, thibitisha kuwa saraka ya bin ya kimataifa iko kwenye PATH.
Miundo maalum haionekani kwenye /model: Thibitisha kuwa models.json iko kwenye ~/.pi/agent/, thibitisha kuwa apiKey inaweza kutatuliwa, na kisha ufungue tena /model.
Windows inaripoti kuwa Bash haiwezi kupatikana: Sakinisha Git for Windows, au weka shellPath katika ~/.pi/agent/settings.json. Mikwaju ya nyuma katika JSON lazima iandikwe mara mbili.
Ombi linakataliwa: Angalia kuwa api ni openai-completions na kwamba baseUrl inaishia na /v1. Usiwezeshe chaguo za ziada za utangamano kwa sababu tu huduma inajielezea kama inayooana.
Kitambulisho cha muundo si sahihi: Nakili tena kutoka kwa orodha ya sasa ya OmniProxy.

Marejeleo rasmi

Kwa amri za usakinishaji, angalia Pi website na Quickstart. Kwa faili ya muundo, angalia Choose a Model na Configuration. Kwa mazingira ya amri ya Windows, angalia Run Pi on Windows. Kwa vitambulisho vya muundo vinavyotumiwa katika mifano, angalia Gemini model list na xAI models page.

Badilisha kila nafasi yenye thamani kutoka kwenye usanidi wako wa OmniProxy. Usitangaze funguo halisi.

Matokeo yaliyohifadhiwa au HTTP 200 pekee hayathibitishi utangamano kamili wa Agent. Angalia chanzo na mfano katika rekodi ya maombi ya OmniProxy.

Vyanzo rasmi · Pi ↗