Namestitev Pi in konfiguracija OmniProxy

Pi je majhen pomočnik za terminal—program, ki se z vami pogovarja neposredno v ukazni vrstici, bere datoteke in opravlja naloge. Ima kratek sistemski poziv in privzeto le nekaj orodij. Če potrebujete druge ukaze, poteke dela ali vmesnike, jih lahko pozneje dodate prek razširitev. Razširitve so komponente, ki Pi dodajo zmogljivosti, po ustvarjanju pa jih lahko delite z drugimi.

Podagenti del naloge prenesejo na drugega pomočnika, medtem ko način načrtovanja organizira korake, preden se začne izvajanje. Nobena funkcija ni vključena privzeto, vendar lahko Pi prosite, da jih zgradi, ali pa namestite pakete, ki so jih delili drugi.

Preden začnete

macOS in Linux uporabljata namestitveni skript—en sam ukaz, ki samodejno prenese in namesti Pi. V sistemu Windows uporabite ukaz PowerShell, ki je na voljo na domači strani Pi. PowerShell je ukazno okolje, vključeno v Windows. Pi lahko namestite tudi v WSL, Linux okolju, ki je na voljo znotraj Windowsa.

Če se odločite za namestitev z npm, potrebujete Node.js 22.19 ali novejši. npm je upravljalnik paketov, ki se uporablja z Node.js in lahko namesti Pi iz ukazne vrstice.

macOS Linux

install.sh

• curl uradni skript
• Namestitveni program pripne odvisnosti
• Posodobite s pi update

Windows

install.ps1

• Uradni ukaz PowerShell
• Git for Windows zagotavlja Bash
• Uporabite lahko tudi WSL

Node je že nameščen

npm

• Zahteva Node 22.19+
• Ime paketa je pi-coding-agent
• Dodajte --ignore-scripts

Namestitev in prvi zagon Pi

Na macOS ali Linux odprite terminal in zaženite:

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

Na Windows odprite PowerShell in zaženite:

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

Če je Node.js 22.19 ali novejši že nameščen, lahko uporabite tudi nadomestni ukaz iz Quickstarta:

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

Namestitveni skript se lahko ustavi in v interaktivnem terminalu postavi vprašanja. Sledite pozivom na zaslonu za nadaljevanje. Če že imate združljivo različico Node, ta ukaz npm ne bo postavljal vprašanj. Za namestitev Pi v drug imenik dodajte --prefix /your/directory. Dne 2026-10-09 je to namestilo Pi 1.1.0.

Običajna namestitev npm ne zahteva skriptov življenjskega cikla odvisnosti, ki so skripti, ki jih paketi samodejno izvajajo med namestitvijo. Namestitveni skript pripne odvisnosti; pozneje posodobite Pi z pi update. Za namestitev npm uporabite metodo posodobitve, ki jo zagotavlja vaš upravljalnik paketov. Uporabniki Nix naj namestijo iz Pi-jevega flakea. Flake je konfiguracija Nix, ki opisuje programsko opremo in njene odvisnosti, pi update pa ne more posodobiti namestitve Nix.

Po namestitvi najprej potrdite, da terminal lahko najde Pi:

pi --version

V sistemu Windows je za večino lokalnih uporabnikov priporočljiva namestitev Git for Windows, če želite, da modeli izvajajo ukaze Bash. Bash je ukazno okolje, ki ga Pi uporablja za izvajanje nekaterih ukazov. Pi preveri nastavitev shellPath v ~/.pi/agent/settings.json, Git Bash pod Program Files in nato bash.exe v PATH, v tem vrstnem redu. shellPath določa lokacijo Bash, medtem ko je PATH seznam imenikov, v katerih sistem išče ukaze.

Po zagonu Pi lahko vnesete !printf 'Bash is working\n', da ga preverite. Če so vaše datoteke in orodja že v WSL, namestite Pi v tem Linux okolju po navodilih v Quickstartu.

Nato vstopite v mapo, ki jo želite, da Pi pregleda ali obdela, in ga zaženite:

cd /path/to/folder
pi

Ta mapa postane trenutni delovni obseg Pi. Pi jo uporablja za odkrivanje datotek in konfiguracije ter za združevanje sej.

Pridobitev povezovalnih vrednosti iz OmniProxy

Najprej pridobite te tri vrednosti iz 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 je končna točka API, na katero Pi pošilja zahteve, in mora vključevati /v1. apiKey je ključ, ki se uporablja za dostop do API-ja. Model ID je ime modela za klic in ga je treba v celoti kopirati s trenutnega seznama modelov OmniProxy.

Nastavite api na openai-completions, kot je prikazano v primeru združljivega API-ja. To polje pove Pi, kateri format API-ja naj uporabi pri pošiljanju zahtev.

Kopirajte celoten ID modela, vključno s poševnicami v imenu. Dne 2026-10-09 sta bila referenčna ID-ja v dokumentaciji ponudnika gemini-3.8-flash in grok-4.7. Ne kopirajte imena, ki ga ni na seznamu.

Vnos konfiguracije orodja

Konfiguracija modela po meri na ravni uporabnika za Pi je shranjena v models.json. Ta datoteka se nahaja v imeniku agenta, ki je privzeto ~/.pi/agent, zato je njena polna pot ~/.pi/agent/models.json. Če je nastavljena okoljska spremenljivka PI_CODING_AGENT_DIR, Pi namesto tega uporabi imenik, določen s to spremenljivko. Okoljska spremenljivka je konfiguracijska vrednost, ki jo sistem zagotovi za branje programom.

Vnesite konfiguracijo, kot je prikazano v primeru združljivega API-ja:

{
  "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 navaja povezane storitve, medtem ko models navaja modele, ki jih je mogoče izbrati. Vsak id modela se mora ujemati s celotnim ID-jem modela na trenutnem seznamu modelov OmniProxy. input označuje, da je model tukaj konfiguriran za vnos besedila.

apiKey lahko vnesete kot dobesedno vrednost ali kot $NAME oziroma ${NAME}, tako da Pi bere iz okoljske spremenljivke. Vrednost, ki se začne z !, se obravnava kot ukaz in se izvede za vsako zahtevo. Pravega ključa ne shranjujte v repozitorij. Če prehod ne preverja ključev, lahko vnesete nadomestni niz, ki se uporablja samo na vašem lokalnem računalniku. Dne 2026-10-09 je Pi uspešno prebral datoteko s to konfiguracijo.

Odpiranje /model znova naloži to datoteko. /model je vmesnik v Pi za ogled in izbiro modelov. Modeli po meri se ne prikažejo v /model, dokler Pi ne more razrešiti njihovih poverilnic. Po izbiri modela pritisnite Ctrl+S, da ga shranite kot privzeti model za nove seje.

Datoteka

models.json

• Privzeti imenik: ~/.pi/agent
• Dodajte vnos pod providers
• Nastavite api na completions

Naslov

baseUrl

• Vključite /v1
• apiKey se lahko sklicuje na spremenljivko
• ID modela mora biti točen

Izberite

/model

• Odpiranje znova naloži datoteko
• Izberite model, ki ste ga pravkar dodali
• Ctrl+S ga shrani kot privzetega

Preverjanje z dejansko nalogo

Po dokončanju konfiguracije lahko opravite neinteraktivno preverjanje v imeniku, ki vsebuje datoteke. Neinteraktivni način pomeni, da Pi dokonča to eno nalogo in nato konča, namesto da vstopi v tekoči pogovor. Zamenjajte vrednost za --model s celotnim ID-jem s trenutnega seznama OmniProxy:

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

Tukaj --tools read omogoči samo orodje za branje, naloga pa tudi izrecno naroči Pi, naj datoteke ne spreminja. Dne 2026-10-09 je Pi 1.1.0 uspešno prebral vsebino datoteke. Prvi odgovor je trajal približno dve minuti.

Uporabite lahko tudi interaktivni način: vstopite v imenik, zaženite pi in nato izberite model z /model. En primer naloge v Quickstartu prosi Pi, naj razloži, kako je organiziran repozitorij in kako zagnati njegove preglede. Opazujte, ali bere datoteke in poda razlago, nato preverite vir in ID modela v dnevnikih zahtev OmniProxy.

Zagon

Pi se zažene

• Najprej cd v mapo
• pi --version izpiše podatke
• Ime modela se prikaže na dnu vmesnika

Naloga

Prebral je imenik

• Vprašajte, kako je organiziran repozitorij
• Preglejte datoteke, ki jih navede
• Ne zanašajte se samo na uspešno shranjeno konfiguracijo

Dnevniki

Vidno v gatewayu

• Vir je Pi
• ID modela se ujema
• Ključ hranite na lokalnem računalniku

Pogoste napake

• pi ni mogoče najti: Znova odprite terminal in znova poskusite pi --version. Za namestitev npm potrdite, da je globalni imenik bin v PATH.
• Modeli po meri se ne prikažejo v /model: Potrdite, da je models.json v ~/.pi/agent/, preverite, ali je mogoče razrešiti apiKey, nato znova odprite /model.
• Windows poroča, da Bash ni mogoče najti: Namestite Git for Windows ali nastavite shellPath v ~/.pi/agent/settings.json. Poševnice v JSON morajo biti zapisane dvakrat.
• Zahteva je zavrnjena: Preverite, ali je api nastavljen na openai-completions in da se baseUrl konča z /v1. Ne omogočajte dodatnih možnosti združljivosti samo zato, ker se storitev opisuje kot združljiva.
• ID modela je neveljaven: Ponovno ga kopirajte s trenutnega seznama OmniProxy.

Uradne reference

Za ukaze za namestitev glejte Pi website in Quickstart. Za datoteko modela glejte Choose a Model in Configuration. Za ukazno okolje Windows glejte Run Pi on Windows. Za ID-je modelov, uporabljene v primerih, glejte Gemini model list in xAI models page.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti Agentov. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Pi ↗