Namestitev Pi in konfiguracija OmniProxy

Pi je majhen terminalski pomočnik – program, ki neposredno komunicira z vami 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 zmožnosti, po izdelavi pa jih lahko delite z drugimi.

Podpomočniki (subagents) prenesejo del naloge na drugega pomočnika, medtem ko način načrtovanja (plan mode) organizira korake pred začetkom izvajanja. Nobena od teh funkcij ni privzeto vključena, vendar lahko Pi prosite, da ju izdela, 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 okolje ukazne vrstice, vključeno v Windows. Pi lahko namestite tudi v WSL, Linux okolje, ki je na voljo v sistemu Windows.

Č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 določi odvisnosti
• Posodobite z 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 programa Pi

V sistemu macOS ali Linux odprite terminal in zaženite:

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

V sistemu 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 hitrega začetka (Quickstart):

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. Na dan 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 izvedejo med namestitvijo. Namestitveni skript določi odvisnosti; pozneje posodobite Pi z pi update. Za namestitev npm uporabite metodo posodabljanja, ki jo zagotavlja vaš upravljalnik paketov. Uporabniki Nix naj namestijo iz Pi flake. Flake je konfiguracija Nix, ki opisuje programsko opremo in njene odvisnosti, in pi update ne more posodobiti namestitve Nix.

Po namestitvi najprej potrdite, da vaš terminal 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 v Program Files in nato bash.exe na 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 to Linux okolje po navodilih za hitri začetek.

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

cd /path/to/folder
pi

Ta mapa postane trenutni delovni obseg programa 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. Model ID je ime modela, ki ga želite poklicati, in ga morate v celoti kopirati s trenutnega seznama modelov OmniProxy.

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

Kopirajte celoten ID modela, vključno s poševnicami v imenu. Na dan 2026-10-09 sta bila dva 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 celotna 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 programom za branje.

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

{
  "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}, da jo Pi prebere iz okoljske spremenljivke. Vrednost, ki se začne z !, se obravnava kot ukaz in se izvede za vsako zahtevo. Ne objavljajte pravega ključa v repozitoriju. Če prehod (gateway) ne preverja ključev, lahko vnesete nadomestni niz, ki se uporablja samo v vašem lokalnem računalniku. Na dan 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 lahko sklicuje 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 s pravo nalogo

Po zaključku 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 bi vstopil 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. Na dan 2026-10-09 je Pi 1.1.0 uspešno prebral vsebino datoteke. Prvi odziv je trajal približno dve minuti.

Uporabite lahko tudi interaktivni način: vstopite v imenik, zaženite pi in nato izberite model z /model. Ena od nalog v hitrem začetku prosi Pi, naj razloži, kako je organiziran repozitorij in kako zagnati njegove preglede. Opazujte, ali bere datoteke in poda razlago, nato pa potrdite vir in ID modela v dnevnikih zahtev OmniProxy.

Zagon

pi se zažene

• Najprej cd v mapo
• pi --version ustvari izpis
• 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 shranjevanje konfiguracije

Dnevniki

Vidno v prehodu (gateway)

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

Pogoste napake

• pi ni mogoče najti: Znova odprite terminal in poskusite znova z pi --version. Pri namestitvi npm potrdite, da je globalni imenik bin na 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, in 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 nazaj (backslashes) v zapisu JSON morajo biti zapisane dvakrat.
• Zahteva je zavrnjena: Preverite, ali je api enak 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 ni veljaven: Znova ga kopirajte s trenutnega seznama OmniProxy.

Uradne reference

Za ukaze za namestitev glejte spletno mesto Pi in hitri začetek. Za datoteko modela glejte Izbira modela in Konfiguracija. Za ukazno okolje Windows glejte Zagon Pi v sistemu Windows. Za ID-je modelov, uporabljene v primerih, glejte seznam modelov Gemini in stran modelov xAI.

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 agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Pi ↗