Installere Pi og konfigurere OmniProxy

Pi er en liten terminalassistent—et program som snakker med deg direkte i kommandolinjen, leser filer og fullfører oppgaver. Den har en kort systemmelding og kun noen få verktøy som standard. Hvis du trenger andre kommandoer, arbeidsflyter eller grensesnitt, kan du legge dem til senere gjennom utvidelser. Utvidelser er komponenter som legger til funksjonalitet i Pi, og du kan dele dem med andre etter at du har opprettet dem.

Underagenter delegerer deler av en oppgave til en annen assistent, mens planmodus organiserer trinnene før utførelsen begynner. Ingen av funksjonene er inkludert som standard, men du kan be Pi om å bygge dem eller installere pakker delt av andre.

Før du starter

macOS og Linux bruker et installasjonsskript—en enkelt kommando som automatisk laster ned og installerer Pi. På Windows, bruk PowerShell-kommandoen som er oppgitt på Pi-hjemmesiden. PowerShell er kommandolinjemiljøet som følger med Windows. Du kan også installere Pi i WSL, Linux-miljøet som er tilgjengelig i Windows.

Hvis du velger å installere med npm, trenger du Node.js 22.19 eller nyere. npm er pakkebehandleren som brukes med Node.js og kan installere Pi fra kommandolinjen.

macOS Linux

install.sh

curl det offisielle skriptet
Installasjonsprogrammet låser avhengighetene
Oppdater med pi update

Windows

install.ps1

Offisiell PowerShell-kommando
Git for Windows leverer Bash
Du kan også bruke WSL

Node er allerede installert

npm

Krever Node 22.19+
Pakkenavnet er pi-coding-agent
Legg til --ignore-scripts

Installasjonsskriptet låser avhengighetene. npm-installasjonen låser ikke transitive avhengigheter og krever --ignore-scripts.

Installer og start Pi for første gang

På macOS eller Linux, åpne en terminal og kjør:

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

På Windows, åpne PowerShell og kjør:

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

Hvis Node.js 22.19 eller nyere allerede er installert, kan du også bruke den alternative kommandoen fra hurtigstarten:

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

Installasjonsskriptet kan pause for å stille spørsmål i en interaktiv terminal. Følg instruksjonene på skjermen for å fortsette. Hvis du allerede har en kompatibel versjon av Node, vil ikke denne npm-kommandoen stille spørsmål. For å installere Pi i en annen katalog, legg til --prefix /your/directory. Den 2026-10-09 installerte dette Pi 1.1.0.

En vanlig npm-installasjon krever ikke avhengighets-livssyklusskript, som er skript pakker kjører automatisk under installasjon. Installasjonsskriptet låser avhengighetene; etterpå, oppdater Pi med pi update. For en npm-installasjon, bruk oppdateringsmetoden som leveres av pakkebehandleren din. Nix-brukere bør installere fra Pis flake. En flake er en Nix-konfigurasjon som beskriver programvare og dens avhengigheter, og pi update kan ikke oppdatere en Nix-installasjon.

Etter installasjon, bekreft først at terminalen din kan finne Pi:

pi --version

På Windows, hvis du vil at modeller skal utføre Bash-kommandoer, anbefales installasjon av Git for Windows for de fleste lokale brukere. Bash er kommandomiljøet Pi bruker for å kjøre noen kommandoer. Pi sjekker shellPath innstillingen i ~/.pi/agent/settings.json, Git Bash under Program Files, og deretter bash.exe på PATH, i den rekkefølgen. shellPath spesifiserer plasseringen av Bash, mens PATH er listen over kataloger systemet søker etter kommandoer i.

Etter å ha startet Pi, kan du skrive inn !printf 'Bash is working\n' for å sjekke den. Hvis filene og verktøyene dine allerede er i WSL, installer Pi i det Linux-miljøet ved å følge hurtigstarten.

Deretter, gå inn i mappen du vil at Pi skal inspisere eller jobbe med, og start den:

cd /path/to/folder
pi

Denne mappen blir Pis gjeldende arbeidsområde. Pi bruker den til å oppdage filer og konfigurasjon og for å gruppere økter.

Hent tilkoblingsverdier fra OmniProxy

Først, hent disse tre verdiene fra 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 er API-endepunktet som Pi sender forespørsler til, og den må inkludere /v1. apiKey er nøkkelen som brukes for å få tilgang til API-et. Model ID er navnet på modellen som skal kalles opp og må kopieres i sin helhet fra den gjeldende OmniProxy-modellisten.

Sett api til openai-completions, som vist i det kompatible API-eksemplet. Dette feltet forteller Pi hvilket API-format som skal brukes når forespørsler sendes.

Kopier hele modell-ID-en, inkludert eventuelle skråstreker i navnet. Den 2026-10-09 var de to referanse-ID-ene i leverandørdokumentasjonen gemini-3.8-flash og grok-4.7. Ikke kopier et navn som ikke er til stede i listen.

Angi verktøykonfigurasjonen

Pis bruker-nivå tilpassede modellkonfigurasjon lagres i models.json. Denne filen er plassert i agentkatalogen, som som standard er ~/.pi/agent, så den fullstendige banen er ~/.pi/agent/models.json. Hvis PI_CODING_AGENT_DIR miljøvariabelen er satt, bruker Pi katalogen spesifisert av den variabelen i stedet. En miljøvariabel er en konfigurasjonsverdi levert av systemet som programmer kan lese.

Skriv inn konfigurasjonen som vist i det kompatible API-eksemplet:

{
  "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 lister de tilkoblede tjenestene, mens models lister modellene som kan velges. Hver modells id må samsvare med den fullstendige modell-ID-en i den gjeldende OmniProxy-modellisten. input indikerer at modellen er konfigurert her for tekstinntasting.

apiKey kan skrives inn som en bokstavelig verdi, eller som $NAME eller ${NAME} slik at Pi leser den fra en miljøvariabel. En verdi som begynner med ! behandles som en kommando og utføres for hver forespørsel. Ikke legg inn en ekte nøkkel i et depot. Hvis gatewayen ikke validerer nøkler, kan du skrive inn en plassholderstreng som kun brukes på din lokale maskin. Den 2026-10-09 leste Pi filen vellykket med denne konfigurasjonen.

Åpning av /model laster inn denne filen på nytt. /model er grensesnittet i Pi for visning og valg av modeller. Tilpassede modeller vises ikke i /model før Pi kan løse legitimasjonene deres. Etter valg av en modell, trykk Ctrl+S for å lagre den som standardmodell for nye økter.

Fil

models.json

Standardkatalog: ~/.pi/agent
Legg til en oppføring under providers
Sett api til completions

Adresse

baseUrl

Inkluder /v1
apiKey kan referere til en variabel
Modell-id må være nøyaktig

Velg

/model

Åpning av den laster inn filen på nytt
Velg modellen du nettopp la til
Ctrl+S lagrer den som standard

Etter redigering av filen, åpne /model i Pi og bekreft at modellene vises.

Bekreft med en ekte oppgave

Etter fullføring av konfigurasjonen kan du utføre en ikke-interaktiv sjekk i en katalog som inneholder filer. Ikke-interaktiv modus betyr at Pi fullfører denne enkeltoppgaven og deretter avsluttes i stedet for å gå inn i en pågående samtale. Erstatt verdien etter --model med den fullstendige ID-en fra den gjeldende OmniProxy-listen:

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

Her, --tools read aktiverer kun leseverktøyet, og oppgaven instruerer også eksplisitt Pi om ikke å endre filen. Den 2026-10-09 leste Pi 1.1.0 filinnholdet vellykket. Det første svaret tok omtrent to minutter.

Du kan også bruke interaktiv modus: gå inn i katalogen, kjør pi, og velg deretter en modell med /model. Ett eksempel på en oppgave i hurtigstarten ber Pi om å forklare hvordan depotet er organisert og hvordan man kjører sjekkene dens. Observer om den leser filene og gir en forklaring, bekreft deretter kilden og modell-ID-en i OmniProxys forespørselslogger.

Start

pi starter

Først cd til mappen
pi --version gir utdata
Modellnavnet vises nederst i grensesnittet

Oppgave

Den leste katalogen

Spør hvordan depotet er organisert
Gjennomgå filene den lister opp
Ikke stol kun på en vellykket konfigurasjonslagring

Logger

Synlig i gatewayen

Kilden er Pi
Modell-ID samsvarer
Behold nøkkelen på den lokale maskinen

Etter at modellnavnet vises nederst i grensesnittet, fullfør én ekte oppgave også.

Vanlige feil

pi kan ikke finnes: Åpne terminalen på nytt og prøv pi --version igjen. For en npm-installasjon, bekreft at den globale bin-katalogen er på PATH.
De tilpassede modellene vises ikke i /model: Bekreft at models.json er i ~/.pi/agent/, verifiser at apiKey kan løses, og åpne deretter /model.
Windows rapporterer at Bash ikke kan finnes: Installer Git for Windows, eller sett shellPath i ~/.pi/agent/settings.json. Skråstreker i JSON må skrives to ganger.
Forespørselen avvises: Sjekk at api er openai-completions og at baseUrl slutter på /v1. Ikke aktiver ytterligere kompatibilitetsalternativer bare fordi tjenesten beskriver seg selv som kompatibel.
Modell-ID-en er ugyldig: Kopier den på nytt fra den gjeldende OmniProxy-listen.

Offisielle referanser

For installasjonskommandoer, se Pi website og Quickstart. For modellfilen, se Choose a Model og Configuration. For Windows-kommandomiljøet, se Run Pi on Windows. For modell-ID-ene som brukes i eksemplene, se Gemini model list og xAI models page.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · Pi ↗