Pi installimine ja OmniProxy konfiguratsioon

Pi on väike terminaliassistent – programm, mis suhtleb teiega otse käsureal, loeb faile ja täidab ülesandeid. Sellel on lühike süsteemiviip ja vaikimisi vaid mõned tööriistad. Kui vajate muid käske, töövooge või liideseid, saate need hiljem laienduste kaudu lisada. Laiendused on komponendid, mis lisavad Pi-le võimalusi, ja saate neid pärast loomist teistega jagada.

Alamagendid delegeerivad osa ülesandest teisele assistendile, samas kui plaanirežiim korraldab sammud enne täitmise algust. Kumbki funktsioon pole vaikimisi kaasatud, kuid võite paluda Pi-l need luua või installida teiste jagatud pakette.

Enne alustamist

macOS ja Linux kasutavad installiskripti – ühte käsku, mis laadib Pi automaatselt alla ja installib. Windowsis kasutage Pi kodulehel pakutavat PowerShell-i käsku. PowerShell on Windowsiga kaasas olev käsureakeskkond. Pi saate installida ka WSL-i, mis on Windowsis saadaval olev Linuxi keskkond.

Kui otsustate installida npm-iga, vajate Node.js 22.19 või uuemat versiooni. npm on Node.js-iga kasutatav paketihaldur ja saab Pi installida käsurealt.

macOS Linux

install.sh

• curl ametlik skript
• Installija kinnitab sõltuvused
• Värskendage käsuga pi update

Windows

install.ps1

• Ametlik PowerShell-i käsk
• Git for Windows pakub Bashi
• Võite kasutada ka WSL-i

Node on juba installitud

npm

• Nõuab Node 22.19+
• Paketi nimi on pi-coding-agent
• Lisage --ignore-scripts

Pi installimine ja esmakordne käivitamine

macOS-il või Linuxil avage terminal ja käivitage:

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

Windowsis avage PowerShell ja käivitage:

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

Kui Node.js 22.19 või uuem on juba installitud, võite kasutada ka alternatiivset käsku kiirjuhendist:

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

Installiskript võib interaktiivses terminalis küsimuste esitamiseks peatuda. Jätkamiseks järgige ekraanil kuvatavaid juhiseid. Kui teil on juba ühilduv Node’i versioon, see npm-i käsk küsimusi ei esita. Pi installimiseks teise kataloogi lisage --prefix /your/directory. 2026-10-09 installis see Pi 1.1.0.

Tavaline npm-i installimine ei nõua sõltuvuste elutsükli skripte, mis on skriptid, mida paketid installimise ajal automaatselt käivitavad. Installiskript kinnitab sõltuvused; pärast seda värskendage Pi-d käsuga pi update. npm-i installimise puhul kasutage oma paketihalduri pakutavat värskendusmeetodit. Nixi kasutajad peaksid installima Pi flake’ist. Flake on Nixi konfiguratsioon, mis kirjeldab tarkvara ja selle sõltuvusi, ning pi update ei saa Nixi installimist värskendada.

Pärast installimist veenduge esmalt, et teie terminal leiab Pi:

pi --version

Windowsis, kui soovite, et mudelid käivitaksid Bashi käske, on enamiku kohalike kasutajate jaoks soovitatav installida Git for Windows. Bash on käsukeskkond, mida Pi kasutab mõne käsu käivitamiseks. Pi kontrollib shellPath seadet failis ~/.pi/agent/settings.json, Git Bashi Program Filesis ja seejärel bash.exe PATH-is, selles järjekorras. shellPath määrab Bashi asukoha, samas kui PATH on kataloogide loend, kust süsteem käske otsib.

Pärast Pi käivitamist saate sisestada !printf 'Bash is working\n' selle kontrollimiseks. Kui teie failid ja tööriistad on juba WSL-is, installige Pi sellesse Linuxi keskkonda, järgides kiirjuhendit.

Järgmisena sisenege kausta, mida soovite, et Pi kontrolliks või millega töötaks, ja seejärel käivitage see:

cd /path/to/folder
pi

Sellest kaustast saab Pi praegune tööulatus. Pi kasutab seda failide ja konfiguratsiooni avastamiseks ning seansside rühmitamiseks.

Ühenduse väärtuste hankimine OmniProxyst

Esmalt hankige OmniProxyst need kolm väärtust:

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 on API lõpp-punkt, kuhu Pi päringud saadab, ja see peab sisaldama /v1. apiKey on API-le juurdepääsemiseks kasutatav võti. Model ID on kutsutava mudeli nimi ja see tuleb kopeerida täies mahus praegusest OmniProxy mudelite loendist.

Seadke api väärtusele openai-completions, nagu on näidatud ühilduva API näites. See väli ütleb Pi-le, millist API vormingut päringute saatmisel kasutada.

Kopeerige kogu mudeli ID, sealhulgas kõik nimes olevad kaldkriipsud. 2026-10-09 olid kaks viite-ID-d teenusepakkuja dokumentatsioonis gemini-3.8-flash ja grok-4.7. Ärge kopeerige nime, mida loendis ei ole.

Tööriista konfiguratsiooni sisestamine

Pi kasutajataseme kohandatud mudeli konfiguratsioon salvestatakse faili models.json. See fail asub agendi kataloogis, mille vaikimisi on ~/.pi/agent, seega on selle täielik tee ~/.pi/agent/models.json. Kui PI_CODING_AGENT_DIR keskkonnamuutuja on seatud, kasutab Pi selle asemel muutuja määratud kataloogi. Keskkonnamuutuja on konfiguratsiooniväärtus, mille süsteem programmidele lugemiseks pakub.

Sisestage konfiguratsioon, nagu on näidatud ühilduva API näites:

{
  "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 loetleb ühendatud teenused, samas kui models loetleb mudelid, mida saab valida. Iga mudeli id peab ühtima täieliku mudeli ID-ga praeguses OmniProxy mudelite loendis. input näitab, et mudel on siin konfigureeritud tekstisisestuse jaoks.

apiKey saab sisestada literaalväärtusena või kui $NAME või ${NAME} nii et Pi loeb seda keskkonnamuutujast. Väärtust, mis algab märgiga !, käsitletakse käsuna ja käivitatakse iga päringu puhul. Ärge lisage hoidlasse päris võtit. Kui lüüs võtmeid ei valideeri, võite sisestada kohatäitja stringi, mida kasutatakse ainult teie kohalikus masinas. 2026-10-09 luges Pi selle konfiguratsiooniga faili edukalt.

Faili /model avamine laadib selle faili uuesti. /model on Pi liides mudelite vaatamiseks ja valimiseks. Kohandatud mudelid ei ilmu jaotises /model enne, kui Pi suudab nende volikirjad lahendada. Pärast mudeli valimist vajutage Ctrl+S selle salvestamiseks uute seansside vaikimisi mudeliks.

Fail

models.json

• Vaikimisi kataloog: ~/.pi/agent
• Lisage kirje jaotise providers alla
• Seadke api väärtuseks completions

Aadress

baseUrl

• Lisage /v1
• apiKey võib viidata muutujale
• Mudeli id peab olema täpne

Valige

/model

• Selle avamine laadib faili uuesti
• Valige mudel, mille just lisasite
• Ctrl+S salvestab selle vaikimisi

Kontrollige tegeliku ülesandega

Pärast konfiguratsiooni lõpetamist saate teha mitteinteraktiivse kontrolli failidega kataloogis. Mitteinteraktiivne režiim tähendab, et Pi täidab selle ühe ülesande ja seejärel väljub, selle asemel et siseneda käimasolevasse vestlusesse. Asendage väärtus pärast --model praeguse OmniProxy loendi täieliku ID-ga:

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

Siin --tools read lubab ainult lugemistööriista ja ülesanne juhendab Pi-d ka selgesõnaliselt faili mitte muutma. 2026-10-09 luges Pi 1.1.0 faili sisu edukalt. Esimene vastus võttis umbes kaks minutit.

Võite kasutada ka interaktiivset režiimi: sisenege kataloogi, käivitage pi, seejärel valige mudel käsuga /model. Üks näidisülesanne kiirjuhendis palub Pi-l selgitada, kuidas hoidla on korraldatud ja kuidas selle kontrolle käivitada. Jälgige, kas see loeb faile ja annab selgituse, seejärel kinnitage OmniProxy päringulogides allikas ja mudeli ID.

Käivitamine

pi käivitub

• Esmalt cd kausta
• pi --version annab väljundi
• Mudeli nimi ilmub liidese allossa

Ülesanne

See luges kataloogi

• Küsige, kuidas hoidla on korraldatud
• Vaadake faile, mida see loetleb
• Ärge lootke ainult edukale konfiguratsiooni salvestamisele

Logid

Nähtav lüüsis

• Allikas on Pi
• Mudeli ID ühtib
• Hoidke võtit kohalikus masinas

Levinud vead

• pi ei leita: Avage terminal uuesti ja proovige pi --version uuesti. npm-i installimise puhul veenduge, et globaalne bin-kataloog on PATH-is.
• Kohandatud mudelid ei ilmu jaotises /model: Veenduge, et models.json on jaotises ~/.pi/agent/, kontrollige, et apiKey on lahendatav, ja seejärel avage uuesti /model.
• Windows teatab, et Bashi ei leita: Installige Git for Windows või seadke shellPath failis ~/.pi/agent/settings.json. JSON-i kaldkriipsud peavad olema kirjutatud kaks korda.
• Päring lükatakse tagasi: Kontrollige, et api on openai-completions ja et baseUrl lõpeb /v1-ga. Ärge lubage täiendavaid ühilduvusvalikuid ainult seetõttu, et teenus kirjeldab end ühilduvana.
• Mudeli ID on kehtetu: Kopeerige see uuesti praegusest OmniProxy loendist.

Ametlikud viited

Installimiskäskude kohta vaadake Pi website ja Quickstart. Mudelifaili kohta vaadake Choose a Model ja Configuration. Windowsi käsukeskkonna kohta vaadake Run Pi on Windows. Näidetes kasutatud mudeli ID-de kohta vaadake Gemini model list ja xAI models page.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · Pi ↗