Pi telepítése és OmniProxy konfigurálása

A Pi egy kis terminálasszisztens—egy program, amely közvetlenül a parancssorban beszélget Önnel, fájlokat olvas és feladatokat hajt végre. Rövid rendszerutasítással rendelkezik, és alapértelmezés szerint csak néhány eszközzel bír. Ha más parancsokra, munkafolyamatokra vagy felületekre van szüksége, később hozzáadhatja azokat bővítményeken keresztül. A bővítmények olyan összetevők, amelyek képességekkel bővítik a Pi-t, és létrehozásuk után megoszthatja őket másokkal.

Az alügynökök (subagents) egy feladat egy részét egy másik asszisztensre delegálják, míg a terv mód (plan mode) a végrehajtás megkezdése előtt megszervezi a lépéseket. Egyik funkció sem tartozék alapértelmezés szerint, de megkérheti a Pi-t, hogy építse fel őket, vagy telepítheti mások által megosztott csomagokat.

Mielőtt elkezdené

A macOS és a Linux telepítőszkriptet használ—egyetlen parancsot, amely automatikusan letölti és telepíti a Pi-t. Windowson használja a Pi honlapján biztosított PowerShell parancsot. A PowerShell a Windowsban található parancssori környezet. A Pi-t telepítheti WSL-ben is, a Windowsban elérhető Linux környezetben.

Ha az npm-mel történő telepítést választja, Node.js 22.19 vagy újabb verzióra van szüksége. Az npm a Node.js-szel használt csomagkezelő, és képes telepíteni a Pi-t a parancssorból.

macOS Linux

install.sh

curl a hivatalos szkriptet
A telepítő rögzíti a függőségeket
Frissítés a pi update paranccsal

Windows

install.ps1

Hivatalos PowerShell parancs
A Git for Windows biztosítja a Bash-t
Használhatja a WSL-t is

A Node már telepítve van

npm

Node 22.19+ szükséges
A csomag neve pi-coding-agent
Adja hozzá a --ignore-scripts kapcsolót

A telepítőszkript rögzíti a függőségeket. Az npm telepítés nem rögzíti a tranzitív függőségeket, és --ignore-scripts szükséges hozzá.

A Pi telepítése és első indítása

macOS-en vagy Linuxon nyisson meg egy terminált, és futtassa:

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

Windowson nyissa meg a PowerShellt, és futtassa:

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

Ha a Node.js 22.19 vagy újabb verziója már telepítve van, használhatja a Gyors üzembe helyezés alternatív parancsát is:

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

A telepítőszkript szünetelhet, hogy kérdéseket tegyen fel egy interaktív terminálban. Kövesse a képernyőn megjelenő utasításokat a folytatáshoz. Ha már rendelkezik a Node kompatibilis verziójával, ez az npm parancs nem tesz fel kérdéseket. A Pi másik könyvtárba történő telepítéséhez adja hozzá a --prefix /your/directory-t. 2026-10-09-én ez telepítette a Pi 1.1.0-t.

A normál npm telepítés nem igényel függőségi életciklus-szkripteket, amelyek olyan szkriptek, amelyeket a csomagok automatikusan futtatnak a telepítés során. A telepítőszkript rögzíti a függőségeket; ezt követően frissítse a Pi-t a pi update-val. Az npm telepítéshez használja a csomagkezelő által biztosított frissítési módszert. A Nix felhasználóknak a Pi flake-jéből kell telepíteniük. A flake egy Nix konfiguráció, amely leírja a szoftvert és annak függőségeit, és a pi update nem tudja frissíteni a Nix telepítést.

A telepítés után először győződjön meg arról, hogy a terminálja meg tudja találni a Pi-t:

pi --version

Windowson, ha azt szeretné, hogy a modellek Bash parancsokat hajtsanak végre, a Git for Windows telepítése ajánlott a legtöbb helyi felhasználó számára. A Bash az a parancskörnyezet, amelyet a Pi egyes parancsok futtatására használ. A Pi ellenőrzi a shellPath beállítást a ~/.pi/agent/settings.json-ban, a Git Bash-t a Program Files alatt, majd a bash.exe-et a PATH-on, ebben a sorrendben. A shellPath határozza meg a Bash helyét, míg a PATH azon könyvtárak listája, ahol a rendszer parancsokat keres.

A Pi elindítása után beírhatja a !printf 'Bash is working\n'-t az ellenőrzéséhez. Ha a fájljai és eszközei már a WSL-ben vannak, telepítse a Pi-t abba a Linux környezetbe a Gyors üzembe helyezés követésével.

Ezután lépjen be abba a mappába, amelyet a Pi-nek meg kell vizsgálnia vagy amelyen dolgoznia kell, majd indítsa el:

cd /path/to/folder
pi

Ez a mappa lesz a Pi aktuális munkaterülete. A Pi ezt használja a fájlok és konfigurációk felfedezésére, valamint a munkamenetek csoportosítására.

Csatlakozási értékek beszerzése az OmniProxytól

Először szerezze be ezt a három értéket az OmniProxytól:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy the full ID from the current OmniProxy model list

A baseUrl az az API-végpont, amelyre a Pi kéréseket küld, és tartalmaznia kell a /v1-t. A apiKey az API eléréséhez használt kulcs. A Model ID a meghívandó modell neve, és teljes egészében ki kell másolni az aktuális OmniProxy modelllistából.

Állítsa a api-t openai-completions-ra, ahogy a kompatibilis API példában látható. Ez a mező megmondja a Pi-nek, hogy milyen API-formátumot használjon a kérések küldésekor.

Másolja ki a teljes modellazonosítót, beleértve a névben lévő perjelt is. 2026-10-09-én a szolgáltatói dokumentációban szereplő két hivatkozási azonosító a gemini-3.8-flash és a grok-4.7 volt. Ne másoljon olyan nevet, amely nem szerepel a listában.

Az eszköz konfigurációjának megadása

A Pi felhasználói szintű egyéni modellkonfigurációja a models.json-ben tárolódik. Ez a fájl az ügynök könyvtárában található, amely alapértelmezés szerint ~/.pi/agent, így a teljes elérési útja ~/.pi/agent/models.json. Ha a PI_CODING_AGENT_DIR környezeti változó be van állítva, a Pi az adott változó által megadott könyvtárat használja helyette. A környezeti változó egy konfigurációs érték, amelyet a rendszer biztosít a programok számára az olvasáshoz.

Adja meg a konfigurációt a kompatibilis API példában látható módon:

{
  "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"] }
      ]
    }
  }
}

A providers felsorolja a csatlakoztatott szolgáltatásokat, míg a models felsorolja a kiválasztható modelleket. Minden modell id-jének meg kell egyeznie az aktuális OmniProxy modelllistában szereplő teljes modellazonosítóval. A input azt jelzi, hogy a modell itt van konfigurálva szöveges bevitelhez.

A apiKey megadható literális értékként, vagy $NAME vagy ${NAME} formában, így a Pi környezeti változóból olvassa ki. A !-vel kezdődő értéket parancsként kezeli a rendszer, és minden kérésnél végrehajtja. Ne véglegesítsen valódi kulcsot egy adattárban. Ha a gateway nem érvényesíti a kulcsokat, megadhat egy helyőrző karakterláncot, amelyet csak a helyi gépen használ. 2026-10-09-én a Pi sikeresen elolvasta a fájlt ezzel a konfigurációval.

A /model megnyitása újratölti ezt a fájlt. A /model a Pi felülete a modellek megtekintésére és kiválasztására. Az egyéni modellek nem jelennek meg a /model-ban, amíg a Pi nem tudja feloldani a hitelesítő adataikat. A modell kiválasztása után nyomja meg a Ctrl+S-t, hogy elmentse alapértelmezett modellként az új munkamenetekhez.

Fájl

models.json

Alapértelmezett könyvtár: ~/.pi/agent
Adjon hozzá egy bejegyzést a providers alá
Állítsa az api-t completions-re

Cím

baseUrl

Tartalmazza a /v1-et
Az apiKey hivatkozhat változóra
A modellazonosítónak pontosnak kell lennie

Kiválasztás

/model

Megnyitása újratölti a fájlt
Válassza ki a most hozzáadott modellt
A Ctrl+S elmenti alapértelmezettként

A fájl szerkesztése után nyissa meg a /model-t a Pi-ben, és erősítse meg, hogy a modellek megjelennek.

Ellenőrzés valódi feladattal

A konfiguráció befejezése után nem interaktív ellenőrzést végezhet egy fájlokat tartalmazó könyvtárban. A nem interaktív mód azt jelenti, hogy a Pi elvégzi ezt az egyetlen feladatot, majd kilép, ahelyett, hogy folyamatos beszélgetésbe kezdene. Cserélje le a --model utáni értéket az aktuális OmniProxy listából származó teljes azonosítóra:

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

Itt a --tools read csak az olvasási eszközt engedélyezi, és a feladat kifejezetten arra utasítja a Pi-t, hogy ne módosítsa a fájlt. 2026-10-09-én a Pi 1.1.0 sikeresen elolvasta a fájl tartalmát. Az első válasz körülbelül két percig tartott.

Használhat interaktív módot is: lépjen be a könyvtárba, futtassa a pi-t, majd válasszon modellt a /model-vel. A Gyors üzembe helyezés egyik példafeladata arra kéri a Pi-t, hogy magyarázza el, hogyan van megszervezve a tárház, és hogyan kell futtatni az ellenőrzéseit. Figyelje meg, hogy elolvassa-e a fájlokat és ad-e magyarázatot, majd erősítse meg a forrást és a modellazonosítót az OmniProxy kérésnaplóiban.

Indítás

a pi elindul

Először cd a mappához
a pi --version kimenetet ad
A modell neve megjelenik az interfész alján

Feladat

Elolvasta a könyvtárat

Kérdezze meg, hogyan van megszervezve a tárház
Tekintse át a felsorolt fájlokat
Ne hagyatkozzon csak a sikeres konfigurációmentésre

Naplók

Látható a gateway-ben

A forrás Pi
A modellazonosító egyezik
Tartsa a kulcsot a helyi gépen

Miután a modell neve megjelenik az interfész alján, hajtson végre egy valódi feladatot is.

Gyakori hibák

A pi nem található: Nyissa meg újra a terminált, és próbálja meg újra a pi --version-t. npm telepítés esetén győződjön meg arról, hogy a globális bin könyvtár a PATH-on van.
Az egyéni modellek nem jelennek meg a /model-ben: Győződjön meg arról, hogy a models.json a ~/.pi/agent/-ben van, ellenőrizze, hogy a apiKey feloldható-e, majd nyissa meg újra a /model-t.
Windows jelzi, hogy a Bash nem található: Telepítse a Git for Windows-t, vagy állítsa be a shellPath-t a ~/.pi/agent/settings.json-ban. A JSON-ban lévő visszaperjeleket kétszer kell írni.
A kérést elutasították: Ellenőrizze, hogy a api értéke openai-completions, és hogy a baseUrl a /v1-re végződik. Ne engedélyezzen további kompatibilitási opciókat csak azért, mert a szolgáltatás kompatibilisnek írja le magát.
A modellazonosító érvénytelen: Másolja ki újra az aktuális OmniProxy listából.

Hivatalos hivatkozások

A telepítési parancsokért lásd a Pi webhelyet és a Gyors üzembe helyezést. A modellfájlért lásd a Modell kiválasztása és a Konfiguráció részt. A Windows parancskörnyezetéért lásd a Pi futtatása Windowson részt. A példákban használt modellazonosítókért lásd a Gemini modell listát és az xAI modellek oldalt.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · Pi ↗