Pi instalēšana un OmniProxy konfigurēšana

Pi ir neliels termināļa asistents — programma, kas sarunājas ar jums tieši komandrindā, lasa failus un pabeidz uzdevumus. Tam ir īsa sistēmas uzvedne un pēc noklusējuma tikai daži rīki. Ja jums ir nepieciešamas citas komandas, darbplūsmas vai saskarnes, varat tās pievienot vēlāk, izmantojot paplašinājumus. Paplašinājumi ir komponenti, kas pievieno Pi iespējas, un pēc to izveides varat tos kopīgot ar citiem.

Apakšaģenti deleģē daļu uzdevuma citam asistentam, savukārt plāna režīms organizē soļus pirms izpildes sākuma. Neviena no šīm funkcijām nav iekļauta pēc noklusējuma, taču varat lūgt Pi tās izveidot vai instalēt citu kopīgotās pakotnes.

Pirms sākat

macOS un Linux izmanto instalēšanas skriptu — vienu komandu, kas automātiski lejupielādē un instalē Pi. Operētājsistēmā Windows izmantojiet PowerShell komandu, kas sniegta Pi mājaslapā. PowerShell ir komandrindas vide, kas iekļauta Windows. Varat arī instalēt Pi WSL, Linux vidē, kas pieejama operētājsistēmā Windows.

Ja izvēlaties instalēt ar npm, jums ir nepieciešama Node.js 22.19 vai jaunāka versija. npm ir pakotņu pārvaldnieks, ko izmanto ar Node.js, un tas var instalēt Pi no komandrindas.

macOS Linux

install.sh

• curl oficiālo skriptu
• Instalētājs piesprauž atkarības
• Atjauniniet ar pi update

Windows

install.ps1

• Oficiālā PowerShell komanda
• Git for Windows nodrošina Bash
• Varat izmantot arī WSL

Node jau ir instalēta

npm

• Nepieciešama Node 22.19+
• Pakotnes nosaukums ir pi-coding-agent
• Pievienojiet --ignore-scripts

Pi instalēšana un pirmā palaišana

Operētājsistēmā macOS vai Linux atveriet termināli un palaidiet:

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

Operētājsistēmā Windows atveriet PowerShell un palaidiet:

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

Ja Node.js 22.19 vai jaunāka versija jau ir instalēta, varat izmantot arī alternatīvo komandu no Quickstart:

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

Instalēšanas skripts var apstāties, lai uzdotu jautājumus interaktīvā terminālī. Sekojiet ekrānā redzamajiem norādījumiem, lai turpinātu. Ja jums jau ir saderīga Node versija, šī npm komanda neuzdos jautājumus. Lai instalētu Pi citā direktorijā, pievienojiet --prefix /your/directory. 2026-10-09 tas instalēja Pi 1.1.0.

Parasta npm instalēšana neprasa atkarību dzīves cikla skriptus, kas ir skripti, kurus pakotnes automātiski palaiž instalēšanas laikā. Instalēšanas skripts piesprauž atkarības; pēc tam atjauniniet Pi ar pi update. npm instalēšanai izmantojiet atjaunināšanas metodi, ko nodrošina jūsu pakotņu pārvaldnieks. Nix lietotājiem jāinstalē no Pi flake. Flake ir Nix konfigurācija, kas apraksta programmatūru un tās atkarības, un pi update nevar atjaunināt Nix instalēšanu.

Pēc instalēšanas vispirms pārliecinieties, ka jūsu terminālis var atrast Pi:

pi --version

Operētājsistēmā Windows, ja vēlaties, lai modeļi izpilda Bash komandas, lielākajai daļai lokālo lietotāju ieteicams instalēt Git for Windows. Bash ir komandu vide, ko Pi izmanto dažu komandu palaišanai. Pi pārbauda shellPath iestatījumu ~/.pi/agent/settings.json, Git Bash zem Program Files, un pēc tam bash.exe uz PATH, šādā secībā. shellPath norāda Bash atrašanās vietu, savukārt PATH ir to direktoriju saraksts, kuros sistēma meklē komandas.

Pēc Pi palaišanas varat ievadīt !printf 'Bash is working\n' lai to pārbaudītu. Ja jūsu faili un rīki jau atrodas WSL, instalējiet Pi šajā Linux vidē, sekojot Quickstart.

Pēc tam ievadiet mapi, kuru vēlaties, lai Pi pārbauda vai strādā ar to, un pēc tam palaidiet to:

cd /path/to/folder
pi

Šī mape kļūst par Pi pašreizējo darba darbības jomu. Pi to izmanto, lai atklātu failus un konfigurāciju, kā arī lai grupētu sesijas.

Savienojuma vērtību iegūšana no OmniProxy

Vispirms iegūstiet šīs trīs vērtības no 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 ir API galapunkts, uz kuru Pi sūta pieprasījumus, un tajā jābūt iekļautam /v1. apiKey ir atslēga, ko izmanto piekļuvei API. Model ID ir izsaucamo modeļa nosaukums, un tas ir pilnībā jākopē no pašreizējā OmniProxy modeļu saraksta.

Iestatiet api uz openai-completions, kā parādīts saderīgajā API piemērā. Šis lauks norāda Pi, kuru API formātu izmantot, sūtot pieprasījumus.

Kopējiet visu modeļa ID, ieskaitot visas slīpsvītras nosaukumā. 2026-10-09 divi atsauces ID pakalpojumu sniedzēja dokumentācijā bija gemini-3.8-flash un grok-4.7. Nekopējiet nosaukumu, kas nav redzams sarakstā.

Rīka konfigurācijas ievadīšana

Pi lietotāja līmeņa pielāgotā modeļa konfigurācija tiek saglabāta models.json. Šis fails atrodas aģenta direktorijā, kas pēc noklusējuma ir ~/.pi/agent, tāpēc tā pilnais ceļš ir ~/.pi/agent/models.json. Ja PI_CODING_AGENT_DIR vides mainīgais ir iestatīts, Pi tā vietā izmanto šī mainīgā norādīto direktoriju. Vides mainīgais ir konfigurācijas vērtība, ko sistēma sniedz programmām nolasīšanai.

Ievadiet konfigurāciju, kā parādīts saderīgajā API piemērā:

{
  "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 uzskaita pievienotos pakalpojumus, savukārt models uzskaita modeļus, kurus var atlasīt. Katra modeļa id jāatbilst pilnajam modeļa ID pašreizējā OmniProxy modeļu sarakstā. input norāda, ka modelis šeit ir konfigurēts teksta ievadei.

apiKey var ievadīt kā burtisku vērtību vai kā $NAME vai ${NAME} lai Pi to nolasītu no vides mainīgā. Vērtība, kas sākas ar ! tiek uzskatīta par komandu un izpildīta katram pieprasījumam. Neievietojiet īstu atslēgu repozitorijā. Ja vārteja nevalidē atslēgas, varat ievadīt viettura virkni, kas tiek izmantota tikai jūsu lokālajā datorā. 2026-10-09 Pi veiksmīgi izlasīja failu ar šo konfigurāciju.

Atverot /model tiek atkārtoti ielādēts šis fails. /model ir Pi saskarne modeļu skatīšanai un atlasei. Pielāgotie modeļi neparādās /model līdz Pi var atrisināt to akreditācijas datus. Pēc modeļa atlases nospiediet Ctrl+S lai saglabātu to kā noklusējuma modeli jaunām sesijām.

Fails

models.json

• Noklusējuma direktorija: ~/.pi/agent
• Pievienojiet ierakstu zem providers
• Iestatīt api uz completions

Adrese

baseUrl

• Iekļaut /v1
• apiKey var atsaukties uz mainīgo
• Modeļa id jābūt precīzam

Atlasīt

/model

• Atverot to, fails tiek atkārtoti ielādēts
• Atlasiet tikko pievienoto modeli
• Ctrl+S saglabā to kā noklusējuma

Pārbaude ar reālu uzdevumu

Pēc konfigurācijas pabeigšanas varat veikt neinteraktīvu pārbaudi direktorijā, kas satur failus. Neinteraktīvais režīms nozīmē, ka Pi pabeidz šo vienu uzdevumu un pēc tam iziet, nevis sāk notiekošu sarunu. Aizstājiet vērtību pēc --model ar pilno ID no pašreizējā OmniProxy saraksta:

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."

Šeit, --tools read iespējo tikai lasīšanas rīku, un uzdevums arī nepārprotami norāda Pi nemodificēt failu. 2026-10-09 Pi 1.1.0 veiksmīgi izlasīja faila saturu. Pirmā atbilde aizņēma apmēram divas minūtes.

Varat izmantot arī interaktīvo režīmu: ieejiet direktorijā, palaidiet pi, un pēc tam atlasiet modeli ar /model. Viens piemēra uzdevums Quickstart lūdz Pi izskaidrot, kā repozitorijs ir organizēts un kā palaist tā pārbaudes. Novērojiet, vai tas nolasa failus un sniedz skaidrojumu, pēc tam apstipriniet avotu un modeļa ID OmniProxy pieprasījumu žurnālos.

Palaišana

pi palaižas

• Vispirms cd uz mapi
• pi --version sniedz izvadi
• Modeļa nosaukums parādās saskarnes apakšā

Uzdevums

Tas izlasīja direktoriju

• Jautājiet, kā repozitorijs ir organizēts
• Pārskatiet failus, kurus tas uzskaita
• Nepalaidieties tikai uz veiksmīgu konfigurācijas saglabāšanu

Žurnāli

Redzams vārtejā

• Avots ir Pi
• Modeļa ID sakrīt
• Saglabājiet atslēgu lokālajā datorā

Biežākās kļūdas

• pi nevar atrast: Atkārtoti atveriet termināli un mēģiniet pi --version vēlreiz. npm instalēšanai pārliecinieties, ka globālais bin direktorijs ir uz PATH.
• Pielāgotie modeļi neparādās /model: Pārliecinieties, ka models.json ir ~/.pi/agent/, pārbaudiet, vai apiKey var atrisināt, un pēc tam atkārtoti atveriet /model.
• Windows ziņo, ka Bash nevar atrast: Instalējiet Git for Windows vai iestatiet shellPath iekš ~/.pi/agent/settings.json. Atpakaļvērstās slīpsvītras JSON jāraksta divreiz.
• Pieprasījums tiek noraidīts: Pārbaudiet, vai api ir openai-completions un ka baseUrl beidzas ar /v1. Neiespējojiet papildu saderības opcijas tikai tāpēc, ka pakalpojums sevi raksturo kā saderīgu.
• Modeļa ID nav derīgs: Kopējiet to vēlreiz no pašreizējā OmniProxy saraksta.

Oficiālās atsauces

Instalēšanas komandas skatiet Pi website un Quickstart. Modeļu failam skatiet Choose a Model un Configuration. Windows komandu videi skatiet Run Pi on Windows. Lai uzzinātu piemēros izmantotos modeļu ID, skatiet Gemini model list un xAI models page.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · Pi ↗