Instalacija Pi-a i konfiguracija OmniProxy-a

Pi je mali terminalski asistent—program koji razgovara s vama izravno u naredbenom retku, čita datoteke i dovršava zadatke. Ima kratki sistemski upit i prema zadanim postavkama samo nekoliko alata. Ako trebate druge naredbe, tijekove rada ili sučelja, možete ih kasnije dodati putem proširenja. Proširenja su komponente koje dodaju mogućnosti Pi-u, a možete ih dijeliti s drugima nakon što ih stvorite.

Pod-agenti delegiraju dio zadatka drugom asistentu, dok način planiranja organizira korake prije početka izvršavanja. Nijedna značajka nije uključena prema zadanim postavkama, ali možete tražiti od Pi-a da ih izgradi ili instalirati pakete koje dijele drugi.

Prije početka

macOS i Linux koriste instalacijsku skriptu—jednu naredbu koja automatski preuzima i instalira Pi. Na Windowsima koristite PowerShell naredbu navedenu na početnoj stranici Pi-a. PowerShell je okruženje naredbenog retka uključeno u Windows. Pi možete instalirati i u WSL-u, Linux okruženju dostupnom unutar Windowsa.

Ako odlučite instalirati s npm, trebate Node.js 22.19 ili noviji. npm je upravitelj paketa koji se koristi s Node.js-om i može instalirati Pi iz naredbenog retka.

macOS Linux

install.sh

• curl službenu skriptu
• Instalacijski program fiksira ovisnosti
• Ažurirajte s pi update

Windows

install.ps1

• Službena PowerShell naredba
• Git for Windows pruža Bash
• Možete koristiti i WSL

Node je već instaliran

npm

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

Instalacija i prvo pokretanje Pi-a

Na macOS-u ili Linuxu otvorite terminal i pokrenite:

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

Na Windowsima otvorite PowerShell i pokrenite:

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

Ako je Node.js 22.19 ili noviji već instaliran, možete koristiti i alternativnu naredbu iz Quickstart-a:

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

Instalacijska skripta može pauzirati kako bi postavila pitanja u interaktivnom terminalu. Slijedite upute na zaslonu za nastavak. Ako već imate kompatibilnu verziju Node-a, ova npm naredba neće postavljati pitanja. Za instalaciju Pi-a u drugom direktoriju, dodajte --prefix /your/directory. 09.10.2026., ovo je instaliralo Pi 1.1.0.

Normalna npm instalacija ne zahtijeva skripte životnog ciklusa ovisnosti, koje su skripte koje paketi automatski pokreću tijekom instalacije. Instalacijska skripta fiksira ovisnosti; nakon toga, ažurirajte Pi s pi update. Za npm instalaciju koristite metodu ažuriranja koju pruža vaš upravitelj paketa. Nix korisnici trebaju instalirati iz Pi-ovog flake-a. Flake je Nix konfiguracija koja opisuje softver i njegove ovisnosti, a pi update ne može ažurirati Nix instalaciju.

Nakon instalacije, prvo potvrdite da vaš terminal može pronaći Pi:

pi --version

Na Windowsima, ako želite da modeli izvršavaju Bash naredbe, instalacija Git for Windows preporučuje se većini lokalnih korisnika. Bash je naredbeno okruženje koje Pi koristi za pokretanje nekih naredbi. Pi provjerava shellPath postavku u ~/.pi/agent/settings.json, Git Bash pod Program Files, a zatim bash.exe na PATH-u, tim redoslijedom. shellPath navodi lokaciju Bash-a, dok je PATH popis direktorija koje sustav pretražuje za naredbe.

Nakon pokretanja Pi-a, možete unijeti !printf 'Bash is working\n' da biste ga provjerili. Ako su vaše datoteke i alati već u WSL-u, instalirajte Pi u tom Linux okruženju slijedeći Quickstart.

Zatim uđite u mapu koju želite da Pi pregleda ili na kojoj želite raditi, a zatim ga pokrenite:

cd /path/to/folder
pi

Ova mapa postaje Pi-ov trenutni radni opseg. Pi je koristi za otkrivanje datoteka i konfiguracije te za grupiranje sesija.

Dohvaćanje vrijednosti povezivanja iz OmniProxy-a

Prvo dohvatite ove tri vrijednosti iz OmniProxy-a:

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 API krajnja točka na koju Pi šalje zahtjeve i mora uključivati /v1. apiKey je ključ koji se koristi za pristup API-ju. Model ID je ime modela za pozivanje i mora se kopirati u cijelosti s trenutnog popisa modela OmniProxy-a.

Postavite api na openai-completions, kao što je prikazano u primjeru kompatibilnog API-ja. Ovo polje govori Pi-u koji API format koristiti prilikom slanja zahtjeva.

Kopirajte cijeli ID modela, uključujući sve kose crte u imenu. 09.10.2026., dva referentna ID-a u dokumentaciji pružatelja bila su gemini-3.8-flash i grok-4.7. Nemojte kopirati ime koje nije prisutno na popisu.

Unos konfiguracije alata

Pi-ova konfiguracija prilagođenog modela na razini korisnika pohranjena je u models.json. Ova datoteka se nalazi u direktoriju agenta, koji je prema zadanim postavkama ~/.pi/agent, pa je njezina puna putanja ~/.pi/agent/models.json. Ako je PI_CODING_AGENT_DIR varijabla okruženja postavljena, Pi koristi direktorij naveden tom varijablom. Varijabla okruženja je konfiguracijska vrijednost koju sustav isporučuje programima za čitanje.

Unesite konfiguraciju kao što je prikazano u primjeru kompatibilnog 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 navodi povezane usluge, dok models navodi modele koji se mogu odabrati. Svaki model id mora odgovarati potpunom ID-u modela na trenutnom popisu modela OmniProxy-a. input označava da je model ovdje konfiguriran za unos teksta.

apiKey se može unijeti kao doslovna vrijednost, ili kao $NAME ili ${NAME} tako da Pi čita iz varijable okruženja. Vrijednost koja počinje s ! tretira se kao naredba i izvršava za svaki zahtjev. Nemojte predati pravi ključ u repozitorij. Ako gateway ne provjerava ključeve, možete unijeti niz rezerviranog mjesta koji se koristi samo na vašem lokalnom računalu. 09.10.2026., Pi je uspješno pročitao datoteku s ovom konfiguracijom.

Otvaranje /model ponovno učitava ovu datoteku. /model je sučelje u Pi-u za pregled i odabir modela. Prilagođeni modeli se ne pojavljuju u /model dok Pi ne može razriješiti njihove vjerodajnice. Nakon odabira modela, pritisnite Ctrl+S da biste ga spremili kao zadani model za nove sesije.

Datoteka

models.json

• Zadani direktorij: ~/.pi/agent
• Dodajte unos pod providers
• Postavite api na completions

Adresa

baseUrl

• Uključite /v1
• apiKey može referencirati varijablu
• ID modela mora biti točan

Odaberite

/model

• Otvaranje ponovno učitava datoteku
• Odaberite model koji ste upravo dodali
• Ctrl+S sprema ga kao zadanog

Provjera stvarnog zadatka

Nakon dovršetka konfiguracije, možete izvršiti neinteraktivnu provjeru u direktoriju koji sadrži datoteke. Neinteraktivni način znači da Pi dovršava ovaj jedan zadatak i zatim izlazi umjesto ulaska u tekući razgovor. Zamijenite vrijednost nakon --model potpunim ID-om s trenutnog popisa OmniProxy-a:

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

Ovdje, --tools read omogućuje samo alat za čitanje, a zadatak također izričito upućuje Pi da ne mijenja datoteku. 09.10.2026., Pi 1.1.0 uspješno je pročitao sadržaj datoteke. Prvi odgovor trajao je oko dvije minute.

Možete koristiti i interaktivni način: uđite u direktorij, pokrenite pi, a zatim odaberite model s /model. Jedan primjer zadatka u Quickstart-u traži od Pi-a da objasni kako je repozitorij organiziran i kako pokrenuti njegove provjere. Promatrajte čita li datoteke i pruža li objašnjenje, zatim potvrdite izvor i ID modela u zapisima zahtjeva OmniProxy-a.

Pokretanje

pi se pokreće

• Prvo cd u mapu
• pi --version proizvodi izlaz
• Ime modela pojavljuje se na dnu sučelja

Zadatak

Pročitao je direktorij

• Pitajte kako je repozitorij organiziran
• Pregledajte datoteke koje navodi
• Nemojte se oslanjati samo na uspješno spremanje konfiguracije

Zapisnici

Vidljivo u gateway-u

• Izvor je Pi
• ID modela se podudara
• Zadržite ključ na lokalnom računalu

Uobičajene pogreške

• pi se ne može pronaći: Ponovno otvorite terminal i pokušajte pi --version ponovno. Za npm instalaciju, potvrdite da je globalni bin direktorij na PATH-u.
• Prilagođeni modeli se ne pojavljuju u /model: Potvrdite da je models.json u ~/.pi/agent/, provjerite može li se apiKey razriješiti, a zatim ponovno otvorite /model.
• Windows javlja da se Bash ne može pronaći: Instalirajte Git for Windows ili postavite shellPath u ~/.pi/agent/settings.json. Kose crte u JSON-u moraju biti napisane dvaput.
• Zahtjev je odbijen: Provjerite je li api postavljen na openai-completions i da baseUrl završava s /v1. Nemojte omogućivati dodatne opcije kompatibilnosti samo zato što se usluga opisuje kao kompatibilna.
• ID modela nije važeći: Kopirajte ga ponovno s trenutnog popisa OmniProxy-a.

Službene reference

Za naredbe instalacije, pogledajte Pi website i Quickstart. Za datoteku modela, pogledajte Choose a Model i Configuration. Za naredbeno okruženje Windowsa, pogledajte Run Pi on Windows. Za ID-ove modela korištene u primjerima, pogledajte Gemini model list i xAI models page.

Zamijenite svaki predložak vrijednostima iz vlastite OmniProxy konfiguracije. Nikada ne objavite stvarni ključ.

Spremljeni rezultat ili HTTP 200 sami po sebi ne dokazuju punu kompatibilnost Agenta. Provjerite izvor i model u zapisu poziva OmniProxy.

Službeni izvori · Pi ↗