Installazzjoni ta’ Pi u konfigurazzjoni ta’ OmniProxy

Pi huwa assistent żgħir għat-terminal, jiġifieri programm li jitkellem miegħek direttament mil-linja tal-kmand, jaqra l-fajls u jwettaq kompiti. Il-prompt tas-sistema tiegħu huwa qasir u l-għodod predefiniti tiegħu huma limitati; meta jkollok bżonn kmandi, flussi tax-xogħol jew interfaċċi oħra, tista’ żżidhom permezz ta’ estensjonijiet. Estensjoni hija komponent li jżid kapaċitajiet ma’ Pi, u meta tkun lesta tista’ taqsamha ma’ oħrajn.

Sottoaġent jgħaddi parti minn kompitu lil assistent ieħor, filwaqt li l-modalità tal-ippjanar l-ewwel torganizza l-passi u mbagħad tibda teżegwihom. Dawn iż-żewġ funzjonijiet mhumiex inklużi b’mod predefinit, iżda tista’ titlob lil Pi joħloqhom jew tinstalla pakkett maqsum minn xi ħadd ieħor.

Tħejjija qabel l-installazzjoni

macOS u Linux jużaw skript tal-installazzjoni, jiġifieri kmand wieħed li jniżżel u jinstalla kollox awtomatikament. Windows juża l-kmand PowerShell ipprovdut fil-paġna ewlenija ta’ Pi; PowerShell huwa l-ambjent tal-linja tal-kmand inkluż ma’ Windows. Tista’ wkoll tinstalla Pi f’WSL, jiġifieri ambjent Linux ġewwa Windows.

Jekk tagħżel li tinstalla b’npm, l-ewwel għandek bżonn Node.js 22.19 jew verżjoni aktar ġdida. npm huwa l-maniġer tal-pakketti użat ma’ Node.js u jippermettilek tinstalla Pi mil-linja tal-kmand.

macOS Linux

install.sh

Uża curl għall-iskript uffiċjali
L-installatur jiffissa l-verżjonijiet tad-dipendenzi
Uża pi update biex taġġorna

Windows

install.ps1

Uża l-kmand PowerShell mis-sit uffiċjali
Git for Windows jipprovdi Bash
Tista' tuża wkoll WSL

Diġà għandek Node

npm

Jeħtieġ Node 22.19+
L-isem tal-pakkett huwa pi-coding-agent
Żid --ignore-scripts

L-iskript tal-installazzjoni jiffissa l-verżjonijiet tad-dipendenzi. Installazzjoni b’npm ma tiffissax id-dipendenzi indiretti u teħtieġ --ignore-scripts.

Installa u niedi għall-ewwel darba

Fuq macOS jew Linux, iftaħ terminal u ħaddem:

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

Fuq Windows, iftaħ PowerShell u ħaddem:

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

Jekk diġà għandek Node.js 22.19 jew verżjoni aktar ġdida, tista’ tuża wkoll il-kmand alternattiv mill-Quickstart:

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

F’terminal interattiv, l-iskript tal-installazzjoni jista’ jieqaf biex jistaqsik mistoqsijiet; kompli skont dak li jidher fuq l-iskrin. Jekk diġà għandek verżjoni ta’ Node li tissodisfa r-rekwiżiti, dan il-kmand npm ma jistaqsix mistoqsijiet. Biex tinstalla f’direttorju ieħor, żid --prefix /id-direttorju-tiegħek. Fl-2026-10-09, din il-proċedura installat Pi 1.1.0.

Installazzjoni normali b’npm ma teħtieġx l-iskripts taċ-ċiklu tal-ħajja tad-dipendenzi, jiġifieri skripts li l-pakketti jeżegwixxu awtomatikament waqt l-installazzjoni. L-iskript tal-installazzjoni jiffissa l-verżjonijiet tad-dipendenzi; wara tista’ taġġorna b’pi update. Għal installazzjoni b’npm, il-metodu tal-aġġornament jiddependi mill-maniġer tal-pakketti li tuża. L-utenti ta’ Nix għandhom jinstallaw mill-flake ta’ Pi; flake hija konfigurazzjoni li Nix juża biex jiddeskrivi s-softwer u d-dipendenzi tiegħu, u pi update ma jistax jaġġorna installazzjoni ta’ Nix.

Meta tispiċċa l-installazzjoni, l-ewwel ivverifika li t-terminal jista’ jsib lil Pi:

pi --version

Fuq Windows, jekk trid li l-mudell jeżegwixxi kmandi Bash, huwa rakkomandat li l-biċċa l-kbira tal-utenti lokali jinstallaw Git for Windows. Bash huwa l-ambjent tal-kmandi li Pi juża biex jeżegwixxi ċerti kmandi. Pi jfittex, f’din l-ordni, il-valur shellPath f’~/.pi/agent/settings.json, Git Bash taħt Program Files, u bash.exe fil-PATH. shellPath jispeċifika fejn jinsab Bash, filwaqt li PATH hija l-lista ta’ direttorji li s-sistema tfittex fihom għall-kmandi.

Wara li tniedi Pi, tista’ ddaħħal !printf 'Bash is working\n' biex tivverifika. Jekk il-fajls u l-għodod tiegħek diġà jinsabu f’WSL, installa Pi f’dak l-ambjent Linux skont il-Quickstart.

Imbagħad mur fid-direttorju li trid li Pi jeżamina jew jipproċessa u niedih:

cd /path/to/folder
pi

Dan id-direttorju jsir l-ambitu tax-xogħol attwali ta’ Pi. Jintuża biex jinstabu l-fajls u l-konfigurazzjoni, kif ukoll biex is-sessjonijiet jinġabru flimkien.

Ikseb il-parametri tal-konnessjoni minn OmniProxy

L-ewwel ħejji dawn it-tliet valuri minn OmniProxy:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: ikkopja l-ID sħiħa mil-lista attwali tal-mudelli ta’ OmniProxy

baseUrl huwa l-indirizz tal-endpoint fejn Pi jibgħat it-talbiet u għandu jasal sa /v1. apiKey hija ċ-ċavetta użata biex taċċessa l-endpoint. Model ID huwa l-isem tal-mudell li se jintuża u għandu jiġi kkupjat kollu mil-lista attwali tal-mudelli ta’ OmniProxy.

Għal api, uża openai-completions kif muri fl-eżempju tal-endpoint kompatibbli. Dan il-qasam jgħid lil Pi f’liema format għandu jibgħat it-talbiet.

Ikkopja l-ID tal-mudell kollha kemm hi u żomm kwalunkwe slash fl-isem. Fl-2026-10-09, iż-żewġ IDs ta’ referenza fid-dokumentazzjoni tal-fornituri kienu gemini-3.8-flash u grok-4.7. Tużax ismijiet li ma jidhrux fil-lista.

Daħħal il-konfigurazzjoni tal-għodda

Il-konfigurazzjoni tal-mudelli personalizzati ta’ Pi fil-livell tal-utent tinkiteb f’models.json. Dan il-fajl jinsab fid-direttorju tal-aġent, li b’mod predefinit huwa ~/.pi/agent; għalhekk il-post sħiħ huwa ~/.pi/agent/models.json. Jekk tissettja l-varjabbli tal-ambjent PI_CODING_AGENT_DIR, Pi juża d-direttorju speċifikat minnha. Varjabbli tal-ambjent hija valur ta’ konfigurazzjoni li s-sistema tagħmel disponibbli biex programm jaqrah.

Imla l-fajl skont l-eżempju tal-endpoint kompatibbli:

{
  "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 jelenka s-servizzi konnessi, filwaqt li models jelenka l-mudelli li jistgħu jintgħażlu. L-id ta’ kull mudell irid jaqbel mal-Model ID sħiħ mil-lista attwali ta’ OmniProxy, filwaqt li input jindika li din il-konfigurazzjoni tuża input bit-test.

Tista’ ddaħħal valur litterali direttament f’apiKey, jew tuża $NAME jew ${NAME} biex Pi jaqrah minn varjabbli tal-ambjent. Valur li jibda b’! jiġi ttrattat bħala kmand u jiġi eżegwit ma’ kull talba. Tikkommettix ċavetta vera f’repożitorju. Jekk il-gateway ma jivverifikax iċ-ċavetta, tista’ ddaħħal sekwenza fittizja li tintuża lokalment biss. Fl-2026-10-09, Pi qara l-fajl b’din il-konfigurazzjoni.

Meta tiftaħ /model, Pi jerġa’ jgħabbi dan il-fajl. /model huwa l-punt tad-dħul ta’ Pi biex tara u tagħżel il-mudelli. Mudell personalizzat ma jidhirx f’/model qabel ma Pi jkun jista’ jinterpreta l-kredenzjali. Wara li tagħżel mudell, agħfas Ctrl+S biex issalvah bħala l-mudell predefinit għal sessjonijiet ġodda.

Fajl

models.json

Id-direttorju predefinit huwa ~/.pi/agent
Żid entrata f'providers
api juża completions

Indirizz

baseUrl

Għandu jispiċċa b'/v1
apiKey jista' juża varjabbli
L-id tal-mudell trid tkun preċiża

Għażla

/model

Il-fajl jerġa' jitgħabba meta tiftaħha
Agħżel il-mudell li għadek kif żidt
Ctrl+S jista' jissejvjah bħala l-għażla predefinita

Wara li tibdel il-fajl, iftaħ /model f’Pi u kkonferma li jidher il-mudell.

Ivverifika b’kompitu reali

Wara li tlesti l-konfigurazzjoni, tista’ tagħmel verifika mhux interattiva f’direttorju li fih il-fajls. Mhux interattiva tfisser li ma tidħolx f’konverżazzjoni kontinwa; Pi jagħlaq wara li jlesti dan il-kompitu wieħed. Ibdel il-valur wara --model bl-ID sħiħa mil-lista attwali ta’ OmniProxy:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Aqra l-ewwel linja tal-fajl li nispeċifika u tibdilx il-fajl."

Hawnhekk, --tools read jippermetti biss l-għodda tal-qari, u l-kompitu jgħid ukoll b’mod espliċitu biex il-fajl ma jinbidilx. Fl-2026-10-09, Pi 1.1.0 qara l-kontenut tal-fajl b’dan il-mod. L-ewwel tweġiba ħadet madwar żewġ minuti.

Tista’ tuża wkoll il-modalità interattiva: mur fid-direttorju, ħaddem pi, u mbagħad agħżel il-mudell permezz ta’ /model. Wieħed mill-kompiti ta’ eżempju fil-Quickstart jitlob lil Pi jispjega kif huwa organizzat ir-repożitorju u kif jitħaddmu l-verifiki. Iċċekkja jekk jaqrax il-fajls u jagħtix spjegazzjoni, u mbagħad ikkonferma s-sors u l-ID tal-mudell fir-reġistri tat-talbiet ta’ OmniProxy.

Tnedija

pi jista' jinfetaħ

L-ewwel uża cd biex tidħol fil-folder
pi --version jagħti output
L-isem tal-mudell jidher fil-qiegħ tal-interfaċċa

Kompitu

Qara d-direttorju

Staqsi kif huwa organizzat ir-repożitorju
Ara l-fajls li jelenka
Tibbażax biss fuq il-konferma li l-konfigurazzjoni ġiet issejvjata

Reġistru

Jidher fil-gateway

Is-sors huwa Pi
L-ID tal-mudell jaqbel
Iċ-ċavetta tibqa' fuq il-kompjuter lokali

Anki wara li l-isem tal-mudell jidher fil-qiegħ tal-interfaċċa, xorta trid tlesti kompitu reali.

Żbalji komuni

pi ma jinstabx: iftaħ terminal ġdid u erġa’ pprova pi --version. Għal installazzjoni b’npm, ikkonferma li d-direttorju bin globali jinsab fil-PATH.
Il-mudell personalizzat ma jidhirx f’/model: ikkonferma li models.json jinsab f’~/.pi/agent/, li apiKey jista’ jiġi interpretat, u mbagħad erġa’ iftaħ /model.
Windows jgħid li Bash ma jistax jinstab: installa Git for Windows jew issettja shellPath f’~/.pi/agent/settings.json. Fil-JSON, backslash irid jinkiteb darbtejn.
It-talba tiġi miċħuda: ivverifika li api huwa openai-completions u li baseUrl jispiċċa b’/v1. Tattivax għażliet addizzjonali ta’ kompatibbiltà sempliċement għax is-servizz jiddikjara li huwa kompatibbli.
L-ID tal-mudell mhix valida: erġa’ kkopjaha mil-lista attwali ta’ OmniProxy.

Referenzi uffiċjali

Il-kmandi tal-installazzjoni jinsabu fis-sit ta’ Pi u fil-Quickstart. Għall-fajl tal-mudelli, ara Choose a Model u Configuration. Għall-ambjent tal-kmandi fuq Windows, ara Run Pi on Windows. L-IDs tal-mudelli użati fl-eżempji jinsabu fil-lista tal-mudelli Gemini u fil-paġna tal-mudelli xAI.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · Pi ↗