Pi:n asennus ja OmniProxyn konfigurointi

Pi on pieni pääteavustaja – ohjelma, joka keskustelee kanssasi suoraan komentorivillä, lukee tiedostoja ja suorittaa tehtäviä. Sillä on lyhyt järjestelmäkehote ja oletuksena vain muutama työkalu. Jos tarvitset muita komentoja, työnkulkuja tai käyttöliittymiä, voit lisätä niitä myöhemmin laajennusten kautta. Laajennukset ovat komponentteja, jotka lisäävät Pi:n ominaisuuksia, ja voit jakaa niitä muiden kanssa luotuasi ne.

Alagentit delegoivat osan tehtävästä toiselle avustajalle, kun taas suunnitelmatila (plan mode) järjestää vaiheet ennen suorituksen alkamista. Kumpikaan ominaisuus ei sisälly oletuksena, mutta voit pyytää Pi:tä rakentamaan ne tai asentamaan muiden jakamia paketteja.

Ennen kuin aloitat

macOS ja Linux käyttävät asennusskriptiä – yhtä komentoa, joka lataa ja asentaa Pi:n automaattisesti. Käytä Windowsissa Pi:n kotisivulla annettua PowerShell-komentoa. PowerShell on Windowsin mukana tuleva komentoriviympäristö. Voit myös asentaa Pi:n WSL:ään, Windowsin sisällä saatavilla olevaan Linux-ympäristöön.

Jos valitset asennuksen npm:llä, tarvitset Node.js 22.19 tai uudemman version. npm on Node.js:n kanssa käytettävä paketinhallinta, joka voi asentaa Pi:n komentoriviltä.

macOS Linux

install.sh

• curl virallinen skripti
• Asennusohjelma kiinnittää riippuvuudet
• Päivitä komennolla pi update

Windows

install.ps1

• Virallinen PowerShell-komento
• Git for Windows tarjoaa Bashin
• Voit myös käyttää WSL:ää

Node on jo asennettu

npm

• Vaatii Node 22.19+
• Paketin nimi on pi-coding-agent
• Lisää --ignore-scripts

Asennus ja Pi:n ensimmäinen käynnistys

Avaa macOS:ssä tai Linuxissa pääte ja suorita:

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

Avaa Windowsissa PowerShell ja suorita:

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

Jos Node.js 22.19 tai uudempi on jo asennettu, voit käyttää myös Quickstartin vaihtoehtoista komentoa:

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

Asennusskripti saattaa keskeytyä kysyäkseen kysymyksiä interaktiivisessa päätteessä. Seuraa näytön ohjeita jatkaaksesi. Jos sinulla on jo yhteensopiva Node-versio, tämä npm-komento ei kysy kysymyksiä. Jos haluat asentaa Pi:n toiseen hakemistoon, lisää --prefix /your/directory. 9.10.2026 tämä asensi Pi 1.1.0 -version.

Tavallinen npm-asennus ei vaadi riippuvuuksien elinkaariskriptejä, jotka ovat skriptejä, joita paketit suorittavat automaattisesti asennuksen aikana. Asennusskripti kiinnittää riippuvuudet; päivitä Pi sen jälkeen komennolla pi update. Käytä npm-asennuksessa paketinhallintasi tarjoamaa päivitystapaa. Nix-käyttäjien tulisi asentaa Pi:n flakesta. Flake on Nix-konfiguraatio, joka kuvailee ohjelmiston ja sen riippuvuudet, eikä pi update voi päivittää Nix-asennusta.

Varmista asennuksen jälkeen ensin, että pääte löytää Pi:n:

pi --version

Jos haluat mallien suorittavan Bash-komentoja Windowsissa, Git for Windowsin asentaminen on suositeltavaa useimmille paikallisille käyttäjille. Bash on komentoympäristö, jota Pi käyttää joidenkin komentojen suorittamiseen. Pi tarkistaa shellPath asetuksen tiedostossa ~/.pi/agent/settings.json, Git Bashin Program Files -kansiossa ja sitten bash.exe PATH-muuttujassa, tässä järjestyksessä. shellPath määrittää Bashin sijainnin, kun taas PATH on luettelo hakemistoista, joista järjestelmä etsii komentoja.

Kun olet käynnistänyt Pi:n, voit syöttää !printf 'Bash is working\n' tarkistaaksesi sen. Jos tiedostosi ja työkalusi ovat jo WSL:ssä, asenna Pi kyseiseen Linux-ympäristöön noudattamalla Quickstartia.

Siirry seuraavaksi kansioon, jota haluat Pi:n tarkastelevan tai jossa haluat sen työskentelevän, ja käynnistä se sitten:

cd /path/to/folder
pi

Tästä kansiosta tulee Pi:n nykyinen työskentelyalue. Pi käyttää sitä tiedostojen ja konfiguraation löytämiseen sekä istuntojen ryhmittelemiseen.

Hae yhteysarvot OmniProxysta

Hanki ensin nämä kolme arvoa OmniProxysta:

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-päätepiste, johon Pi lähettää pyynnöt, ja sen on sisällettävä /v1. apiKey on avain, jota käytetään API:n käyttämiseen. Model ID on kutsuttavan mallin nimi, ja se on kopioitava kokonaisuudessaan nykyisestä OmniProxy-malliluettelosta.

Aseta api arvoon openai-completions, kuten yhteensopivassa API-esimerkissä on näytetty. Tämä kenttä kertoo Pi:lle, mitä API-muotoa käyttää pyyntöjä lähetettäessä.

Kopioi koko mallin tunniste, mukaan lukien nimen vinoviivat. 9.10.2026 kaksi viitetunnistetta palveluntarjoajan dokumentaatiossa olivat gemini-3.8-flash ja grok-4.7. Älä kopioi nimeä, jota ei ole luettelossa.

Syötä työkalun konfiguraatio

Pi:n käyttäjätason mukautettu mallikonfiguraatio tallennetaan tiedostoon models.json. Tämä tiedosto sijaitsee agenttihakemistossa, jonka oletusarvo on ~/.pi/agent, joten sen koko polku on ~/.pi/agent/models.json. Jos PI_CODING_AGENT_DIR ympäristömuuttuja on asetettu, Pi käyttää kyseisen muuttujan määrittämää hakemistoa. Ympäristömuuttuja on järjestelmän tarjoama konfiguraatioarvo, jota ohjelmat lukevat.

Syötä konfiguraatio kuten yhteensopivassa API-esimerkissä:

{
  "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 luettelee yhdistetyt palvelut, kun taas models luettelee mallit, jotka voidaan valita. Jokaisen mallin id on vastattava täydellistä mallin tunnistetta nykyisessä OmniProxy-malliluettelossa. input osoittaa, että malli on konfiguroitu tässä tekstinsyöttöä varten.

apiKey voidaan syöttää kirjaimellisena arvona tai muodossa $NAME tai ${NAME} , jotta Pi lukee sen ympäristömuuttujasta. Arvo, joka alkaa merkillä ! , käsitellään komentona ja suoritetaan jokaiselle pyynnölle. Älä tallenna oikeaa avainta arkistoon. Jos yhdyskäytävä ei validoi avaimia, voit syöttää paikkamerkkijonon, jota käytetään vain paikallisella koneella. 9.10.2026 Pi luki tiedoston onnistuneesti tällä konfiguraatiolla.

Avaaminen /model lataa tämän tiedoston uudelleen. /model on Pi:n käyttöliittymä mallien tarkasteluun ja valitsemiseen. Mukautetut mallit eivät näy kohdassa /model ennen kuin Pi voi ratkaista niiden valtuustiedot. Kun olet valinnut mallin, paina Ctrl+S tallentaaksesi sen oletusmalliksi uusille istunnoille.

Tiedosto

models.json

• Oletushakemisto: ~/.pi/agent
• Lisää merkintä kohtaan providers
• Aseta api arvoon completions

Osoite

baseUrl

• Sisällytä /v1
• apiKey voi viitata muuttujaan
• Mallin tunnisteen on oltava täsmällinen

Valitse

/model

• Avaaminen lataa tiedoston uudelleen
• Valitse juuri lisäämäsi malli
• Ctrl+S tallentaa sen oletukseksi

Vahvista todellisella tehtävällä

Konfiguraation valmistuttua voit suorittaa ei-interaktiivisen tarkistuksen hakemistossa, joka sisältää tiedostoja. Ei-interaktiivinen tila tarkoittaa, että Pi suorittaa tämän yhden tehtävän ja poistuu sen sijaan, että siirtyisi jatkuvaan keskusteluun. Korvaa arvo kohdan --model jälkeen täydellisellä tunnisteella nykyisestä OmniProxy-luettelosta:

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

Tässä --tools read ottaa käyttöön vain lukutyökalun, ja tehtävä myös nimenomaisesti ohjeistaa Pi:tä olemaan muokkaamatta tiedostoa. 9.10.2026 Pi 1.1.0 luki tiedoston sisällön onnistuneesti. Ensimmäinen vastaus kesti noin kaksi minuuttia.

Voit myös käyttää interaktiivista tilaa: siirry hakemistoon, suorita pi, ja valitse sitten malli komennolla /model. Yksi Quickstartin esimerkkitehtävä pyytää Pi:tä selittämään, miten arkisto on järjestetty ja miten sen tarkistukset suoritetaan. Tarkkaile, lukeeko se tiedostot ja antaako se selityksen, vahvista sitten lähde ja mallin tunniste OmniProxyn pyyntölokeista.

Käynnistys

pi käynnistyy

• Siirry ensin kansioon cd-komennolla
• pi --version tuottaa tulosteen
• Mallin nimi näkyy käyttöliittymän alareunassa

Tehtävä

Se luki hakemiston

• Kysy, miten arkisto on järjestetty
• Tarkista sen luettelemat tiedostot
• Älä luota vain onnistuneeseen konfiguraation tallennukseen

Lokit

Näkyvissä yhdyskäytävässä

• Lähde on Pi
• Mallin tunniste täsmää
• Pidä avain paikallisella koneella

Yleiset virheet

• pi ei löydy: Avaa pääte uudelleen ja yritä pi --version uudelleen. Varmista npm-asennuksessa, että globaali bin-hakemisto on PATH-muuttujassa.
• Mukautetut mallit eivät näy kohdassa /model: Varmista, että models.json on kohdassa ~/.pi/agent/, tarkista, että apiKey voidaan ratkaista, ja avaa sitten uudelleen /model.
• Windows raportoi, ettei Bashia löydy: Asenna Git for Windows tai aseta shellPath tiedostossa ~/.pi/agent/settings.json. JSON-tiedoston kenoviivat on kirjoitettava kahdesti.
• Pyyntö hylätään: Tarkista, että api on openai-completions ja että baseUrl päättyy /v1. Älä ota käyttöön ylimääräisiä yhteensopivuusasetuksia vain siksi, että palvelu kuvailee itseään yhteensopivaksi.
• Mallin tunniste on virheellinen: Kopioi se uudelleen nykyisestä OmniProxy-luettelosta.

Viralliset viitteet

Katso asennuskomennot kohdasta Pi website ja Quickstart. Katso mallitiedosto kohdista Choose a Model ja Configuration. Katso Windowsin komentoympäristö kohdasta Run Pi on Windows. Katso esimerkeissä käytetyt mallitunnisteet kohdista Gemini model list ja xAI models page.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · Pi ↗