„Pi“ diegimas ir „OmniProxy“ konfigūravimas

„Pi“ yra mažas terminalo asistentas – programa, kuri tiesiogiai bendrauja su jumis komandinėje eilutėje, skaito failus ir atlieka užduotis. Jis turi trumpą sistemos raginimą ir pagal numatytuosius nustatymus tik kelis įrankius. Jei reikia kitų komandų, darbo eigų ar sąsajų, vėliau galite jas pridėti per plėtinius. Plėtiniai yra komponentai, kurie prideda „Pi“ galimybių, ir jūs galite jais dalytis su kitais juos sukūrę.

Subagentai deleguoja dalį užduoties kitam asistentui, o plano režimas organizuoja veiksmus prieš pradedant vykdymą. Nė viena funkcija nėra įtraukta pagal numatytuosius nustatymus, tačiau galite paprašyti „Pi“ jas sukurti arba įdiegti kitų bendrinamus paketus.

Prieš pradedant

„macOS“ ir „Linux“ naudoja diegimo scenarijų – vieną komandą, kuri automatiškai atsisiunčia ir įdiegia „Pi“. „Windows“ sistemoje naudokite „PowerShell“ komandą, pateiktą „Pi“ pagrindiniame puslapyje. „PowerShell“ yra komandinės eilutės aplinka, įtraukta į „Windows“. Taip pat galite įdiegti „Pi“ „WSL“ – „Linux“ aplinkoje, prieinamoje „Windows“ sistemoje.

Jei pasirenkate įdiegti su „npm“, jums reikia „Node.js 22.19“ arba naujesnės versijos. „npm“ yra paketų tvarkyklė, naudojama su „Node.js“, ir gali įdiegti „Pi“ iš komandinės eilutės.

macOS Linux

install.sh

• curl oficialų scenarijų
• Diegimo programa užfiksuoja priklausomybes
• Atnaujinkite su „pi update“

Windows

install.ps1

• Oficiali „PowerShell“ komanda
• „Git for Windows“ suteikia „Bash“
• Taip pat galite naudoti „WSL“

„Node“ jau įdiegta

npm

• Reikalauja „Node 22.19+“
• Paketo pavadinimas yra „pi-coding-agent“
• Pridėkite --ignore-scripts

Pirmasis „Pi“ diegimas ir paleidimas

„macOS“ arba „Linux“ sistemoje atidarykite terminalą ir paleiskite:

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

„Windows“ sistemoje atidarykite „PowerShell“ ir paleiskite:

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

Jei „Node.js 22.19“ ar naujesnė versija jau įdiegta, taip pat galite naudoti alternatyvią komandą iš greitojo paleidimo:

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

Diegimo scenarijus gali pristabdyti ir užduoti klausimus interaktyviame terminale. Vadovaukitės ekrane pateikiamais raginimais, kad tęstumėte. Jei jau turite suderinamą „Node“ versiją, ši „npm“ komanda klausimų neužduos. Norėdami įdiegti „Pi“ kitame kataloge, pridėkite --prefix /your/directory. 2026-10-09 tai įdiegė „Pi 1.1.0“.

Įprastas „npm“ diegimas nereikalauja priklausomybių gyvavimo ciklo scenarijų, kurie yra scenarijai, kuriuos paketai automatiškai vykdo diegimo metu. Diegimo scenarijus užfiksuoja priklausomybes; po to atnaujinkite „Pi“ su pi update. „npm“ diegimui naudokite paketų tvarkyklės pateiktą atnaujinimo metodą. „Nix“ vartotojai turėtų įdiegti iš „Pi“ „flake“. „Flake“ yra „Nix“ konfigūracija, aprašanti programinę įrangą ir jos priklausomybes, ir pi update negali atnaujinti „Nix“ diegimo.

Įdiegę, pirmiausia patvirtinkite, kad terminalas gali rasti „Pi“:

pi --version

„Windows“ sistemoje, jei norite, kad modeliai vykdytų „Bash“ komandas, daugumai vietinių vartotojų rekomenduojama įdiegti „Git for Windows“. „Bash“ yra komandų aplinka, kurią „Pi“ naudoja kai kurioms komandoms vykdyti. „Pi“ tikrina shellPath nustatymą ~/.pi/agent/settings.json, „Git Bash“ po „Program Files“, o tada bash.exe „PATH“ kintamajame, tokia tvarka. shellPath nurodo „Bash“ vietą, o „PATH“ yra katalogų, kuriuose sistema ieško komandų, sąrašas.

Paleidę „Pi“, galite įvesti !printf 'Bash is working\n' kad patikrintumėte. Jei jūsų failai ir įrankiai jau yra „WSL“, įdiekite „Pi“ toje „Linux“ aplinkoje vadovaudamiesi greituoju paleidimu.

Tada įeikite į aplanką, kurį norite, kad „Pi“ patikrintų ar su kuriuo dirbtų, ir paleiskite jį:

cd /path/to/folder
pi

Šis aplankas tampa „Pi“ dabartine darbo sritimi. „Pi“ jį naudoja failams ir konfigūracijai atrasti bei sesijoms grupuoti.

Ryšio reikšmių gavimas iš „OmniProxy“

Pirmiausia gaukite šias tris reikšmes iš „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 yra API galinis punktas, į kurį „Pi“ siunčia užklausas, ir jis turi apimti /v1. apiKey yra raktas, naudojamas API pasiekti. Model ID yra iškviečiamo modelio pavadinimas ir turi būti nukopijuotas visas iš dabartinio „OmniProxy“ modelių sąrašo.

Nustatykite api į openai-completions, kaip parodyta suderinamame API pavyzdyje. Šis laukas nurodo „Pi“, kokį API formatą naudoti siunčiant užklausas.

Nukopijuokite visą modelio ID, įskaitant visus pasviruosius brūkšnius pavadinime. 2026-10-09 duomenimis, dvi nuorodos ID teikėjo dokumentacijoje buvo gemini-3.8-flash ir grok-4.7. Nekopijuokite pavadinimo, kurio nėra sąraše.

Įrankio konfigūracijos įvedimas

„Pi“ vartotojo lygio pasirinktinė modelio konfigūracija saugoma models.json. Šis failas yra agento kataloge, kuris pagal numatytuosius nustatymus yra ~/.pi/agent, todėl visas jo kelias yra ~/.pi/agent/models.json. Jei PI_CODING_AGENT_DIR aplinkos kintamasis nustatytas, „Pi“ naudoja to kintamojo nurodytą katalogą. Aplinkos kintamasis yra konfigūracijos reikšmė, kurią sistema pateikia programoms skaityti.

Įveskite konfigūraciją, kaip parodyta suderinamame API pavyzdyje:

{
  "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 išvardija prijungtas paslaugas, o models išvardija modelius, kuriuos galima pasirinkti. Kiekvieno modelio id turi sutapti su visu modelio ID dabartiniame „OmniProxy“ modelių sąraše. input nurodo, kad modelis čia sukonfigūruotas teksto įvesties tikslais.

apiKey galima įvesti kaip tiesioginę reikšmę arba kaip $NAME arba ${NAME} kad „Pi“ jį skaitytų iš aplinkos kintamojo. Reikšmė, prasidedanti ! yra traktuojama kaip komanda ir vykdoma kiekvienai užklausai. Nekelkite tikro rakto į saugyklą. Jei „gateway“ nepatvirtina raktų, galite įvesti vietos rezervavimo eilutę, naudojamą tik jūsų vietiniame kompiuteryje. 2026-10-09 „Pi“ sėkmingai perskaitė failą su šia konfigūracija.

Atidarius /model šis failas įkeliamas iš naujo. /model yra „Pi“ sąsaja modeliams peržiūrėti ir pasirinkti. Pasirinktiniai modeliai nepasirodo /model kol „Pi“ negali išspręsti jų kredencialų. Pasirinkę modelį, paspauskite Ctrl+S kad išsaugotumėte jį kaip numatytąjį modelį naujoms sesijoms.

Failas

models.json

• Numatytasis katalogas: ~/.pi/agent
• Pridėkite įrašą po „providers“
• Nustatykite „api“ į „completions“

Adresas

baseUrl

• Įtraukite /v1
• apiKey gali nurodyti kintamąjį
• Modelio id turi būti tikslus

Pasirinkite

/model

• Atidarius jį, failas įkeliamas iš naujo
• Pasirinkite ką tik pridėtą modelį
• Ctrl+S išsaugo jį kaip numatytąjį

Tikros užduoties patikrinimas

Baigę konfigūraciją, galite atlikti neinteraktyvų patikrinimą kataloge, kuriame yra failų. Neinteraktyvus režimas reiškia, kad „Pi“ atlieka šią vieną užduotį ir tada išeina, užuot pradėjęs nuolatinį pokalbį. Pakeiskite reikšmę po --model visu ID iš dabartinio „OmniProxy“ sąrašo:

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

Čia, --tools read įgalina tik skaitymo įrankį, o užduotis taip pat aiškiai nurodo „Pi“ nemodifikuoti failo. 2026-10-09 „Pi 1.1.0“ sėkmingai perskaitė failo turinį. Pirmasis atsakymas užtruko apie dvi minutes.

Taip pat galite naudoti interaktyvų režimą: įeikite į katalogą, paleiskite pi, tada pasirinkite modelį su /model. Viena iš greitojo paleidimo užduočių prašo „Pi“ paaiškinti, kaip organizuota saugykla ir kaip vykdyti jos patikrinimus. Stebėkite, ar jis skaito failus ir pateikia paaiškinimą, tada patvirtinkite šaltinį ir modelio ID „OmniProxy“ užklausų žurnaluose.

Paleidimas

„pi“ paleidžiamas

• Pirmiausia „cd“ į aplanką
• „pi --version“ pateikia išvestį
• Modelio pavadinimas pasirodo sąsajos apačioje

Užduotis

Jis perskaitė katalogą

• Paklauskite, kaip organizuota saugykla
• Peržiūrėkite failus, kuriuos jis išvardija
• Nepasikliaukite tik sėkmingu konfigūracijos išsaugojimu

Žurnalai

Matomi „gateway“

• Šaltinis yra „Pi“
• Modelio ID sutampa
• Išlaikykite raktą vietiniame kompiuteryje

Dažnos klaidos

• pi nerandama: Iš naujo atidarykite terminalą ir bandykite pi --version dar kartą. „npm“ diegimui patvirtinkite, kad visuotinis „bin“ katalogas yra „PATH“ kintamajame.
• Pasirinktiniai modeliai nepasirodo /model: Patvirtinkite, kad models.json yra ~/.pi/agent/, patikrinkite, ar apiKey gali būti išspręstas, ir tada iš naujo atidarykite /model.
• „Windows“ praneša, kad „Bash“ nerandama: Įdiekite „Git for Windows“ arba nustatykite shellPath po ~/.pi/agent/settings.json. Pasvirieji brūkšniai „JSON“ turi būti įrašyti du kartus.
• Užklausa atmetama: Patikrinkite, ar api yra openai-completions ir kad baseUrl baigiasi /v1. Neįgalinkite papildomų suderinamumo parinkčių tik todėl, kad paslauga apibūdina save kaip suderinamą.
• Modelio ID neteisingas: Nukopijuokite jį dar kartą iš dabartinio „OmniProxy“ sąrašo.

Oficialios nuorodos

Diegimo komandas rasite Pi website ir Quickstart. Modelio failą rasite Choose a Model ir Configuration. „Windows“ komandų aplinką rasite Run Pi on Windows. Pavyzdžiuose naudojamus modelių ID rasite Gemini model list ir xAI models page.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · Pi ↗