Installera Pi och konfigurera OmniProxy

Pi är en liten terminalassistent—ett program som pratar med dig direkt i kommandoraden, läser filer och slutför uppgifter. Den har en kort systemprompt och endast ett fåtal verktyg som standard. Om du behöver andra kommandon, arbetsflöden eller gränssnitt kan du lägga till dem senare via tillägg. Tillägg är komponenter som lägger till funktioner i Pi, och du kan dela dem med andra efter att du skapat dem.

Underagenter delegerar en del av en uppgift till en annan assistent, medan planläget organiserar stegen innan exekveringen börjar. Ingen av funktionerna ingår som standard, men du kan be Pi att bygga dem eller installera paket som delas av andra.

Innan du börjar

macOS och Linux använder ett installationsskript—ett enda kommando som automatiskt laddar ner och installerar Pi. På Windows, använd PowerShell-kommandot som tillhandahålls på Pi-hemsidan. PowerShell är kommandoradsmiljön som ingår i Windows. Du kan även installera Pi i WSL, Linux-miljön som finns tillgänglig i Windows.

Om du väljer att installera med npm behöver du Node.js 22.19 eller senare. npm är pakethanteraren som används med Node.js och kan installera Pi från kommandoraden.

macOS Linux

install.sh

• curl det officiella skriptet
• Installationsprogrammet låser beroenden
• Uppdatera med pi update

Windows

install.ps1

• Officiellt PowerShell-kommando
• Git for Windows tillhandahåller Bash
• Du kan även använda WSL

Node redan installerat

npm

• Kräver Node 22.19+
• Paketnamnet är pi-coding-agent
• Lägg till --ignore-scripts

Installera och starta Pi för första gången

På macOS eller Linux, öppna en terminal och kör:

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

På Windows, öppna PowerShell och kör:

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

Om Node.js 22.19 eller senare redan är installerat kan du även använda det alternativa kommandot från snabbstarten:

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

Installationsskriptet kan pausa för att ställa frågor i en interaktiv terminal. Följ anvisningarna på skärmen för att fortsätta. Om du redan har en kompatibel version av Node kommer detta npm-kommando inte att ställa frågor. För att installera Pi i en annan katalog, lägg till --prefix /your/directory. Den 2026-10-09 installerade detta Pi 1.1.0.

En vanlig npm-installation kräver inte beroendelivscykelskript, vilket är skript som paket kör automatiskt under installationen. Installationsskriptet låser beroenden; därefter uppdaterar du Pi med pi update. För en npm-installation, använd uppdateringsmetoden som tillhandahålls av din pakethanterare. Nix-användare bör installera från Pi’s flake. En flake är en Nix-konfiguration som beskriver programvara och dess beroenden, och pi update kan inte uppdatera en Nix-installation.

Efter installationen, bekräfta först att din terminal kan hitta Pi:

pi --version

På Windows, om du vill att modeller ska exekvera Bash-kommandon, rekommenderas installation av Git for Windows för de flesta lokala användare. Bash är kommandomiljön Pi använder för att köra vissa kommandon. Pi kontrollerar shellPath-inställningen i ~/.pi/agent/settings.json, Git Bash under Program Files, och sedan bash.exe på PATH, i den ordningen. shellPath anger platsen för Bash, medan PATH är listan över kataloger som systemet söker efter kommandon i.

Efter att ha startat Pi kan du ange !printf 'Bash is working\n' för att kontrollera den. Om dina filer och verktyg redan finns i WSL, installera Pi i den Linux-miljön genom att följa snabbstarten.

Gå sedan till mappen du vill att Pi ska inspektera eller arbeta på, och starta den sedan:

cd /path/to/folder
pi

Denna mapp blir Pi:s aktuella arbetsområde. Pi använder den för att upptäcka filer och konfiguration samt för att gruppera sessioner.

Hämta anslutningsvärden från OmniProxy

Först, hämta dessa tre värden från 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 är API-slutpunkten som Pi skickar förfrågningar till, och den måste inkludera /v1. apiKey är nyckeln som används för att komma åt API:et. Model ID är namnet på modellen som ska anropas och måste kopieras i sin helhet från den aktuella OmniProxy-modellistan.

Ställ in api till openai-completions, som visas i exemplet för kompatibelt API. Detta fält talar om för Pi vilket API-format som ska användas när förfrågningar skickas.

Kopiera hela modell-ID:t, inklusive eventuella snedstreck i namnet. Den 2026-10-09 var de två referens-ID:na i leverantörsdokumentationen gemini-3.8-flash och grok-4.7. Kopiera inte ett namn som inte finns i listan.

Ange verktygskonfigurationen

Pi:s användarnivå-anpassade modellkonfiguration lagras i models.json. Denna fil finns i agentkatalogen, som som standard är ~/.pi/agent, så dess fullständiga sökväg är ~/.pi/agent/models.json. Om miljövariabeln PI_CODING_AGENT_DIR är inställd använder Pi katalogen som anges av den variabeln istället. En miljövariabel är ett konfigurationsvärde som tillhandahålls av systemet för program att läsa.

Ange konfigurationen som visas i exemplet för kompatibelt 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 listar de anslutna tjänsterna, medan models listar modellerna som kan väljas. Varje modells id måste matcha det fullständiga modell-ID:t i den aktuella OmniProxy-modellistan. input indikerar att modellen är konfigurerad här för textinmatning.

apiKey kan anges som ett bokstavligt värde, eller som $NAME eller ${NAME} så att Pi läser det från en miljövariabel. Ett värde som börjar med ! behandlas som ett kommando och exekveras för varje förfrågan. Skicka inte in en riktig nyckel till ett arkiv. Om gatewayen inte validerar nycklar kan du ange en platshållarsträng som endast används på din lokala maskin. Den 2026-10-09 läste Pi filen framgångsrikt med denna konfiguration.

Att öppna /model laddar om denna fil. /model är gränssnittet i Pi för att visa och välja modeller. Anpassade modeller visas inte i /model förrän Pi kan lösa deras autentiseringsuppgifter. Efter att ha valt en modell, tryck på Ctrl+S för att spara den som standardmodell för nya sessioner.

Fil

models.json

• Standardkatalog: ~/.pi/agent
• Lägg till en post under providers
• Ställ in api till completions

Adress

baseUrl

• Inkludera /v1
• apiKey kan referera till en variabel
• Modell-id:t måste vara exakt

Välj

/model

• Att öppna den laddar om filen
• Välj modellen du just lade till
• Ctrl+S sparar den som standard

Verifiera med en verklig uppgift

Efter att ha slutfört konfigurationen kan du utföra en icke-interaktiv kontroll i en katalog som innehåller filer. Icke-interaktivt läge innebär att Pi slutför denna enstaka uppgift och sedan avslutas istället för att gå in i en pågående konversation. Ersätt värdet efter --model med det fullständiga ID:t från den aktuella OmniProxy-listan:

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

Här aktiverar --tools read endast läsverktyget, och uppgiften instruerar även uttryckligen Pi att inte ändra filen. Den 2026-10-09 läste Pi 1.1.0 filinnehållet framgångsrikt. Det första svaret tog cirka två minuter.

Du kan också använda interaktivt läge: gå till katalogen, kör pi och välj sedan en modell med /model. Ett exempel på en uppgift i snabbstarten ber Pi att förklara hur arkivet är organiserat och hur man kör dess kontroller. Observera om den läser filerna och ger en förklaring, bekräfta sedan källan och modell-ID:t i OmniProxys förfrågningsloggar.

Starta

pi startar

• cd först till mappen
• pi --version ger utdata
• Modellnamnet visas längst ner i gränssnittet

Uppgift

Den läste katalogen

• Fråga hur arkivet är organiserat
• Granska filerna den listar
• Förlita dig inte bara på en lyckad konfigurationssparande

Loggar

Synliga i gatewayen

• Källan är Pi
• Modell-ID matchar
• Behåll nyckeln på den lokala maskinen

Vanliga fel

• pi kan inte hittas: Öppna terminalen igen och försök pi --version igen. För en npm-installation, bekräfta att den globala bin-katalogen finns på PATH.
• De anpassade modellerna visas inte i /model: Bekräfta att models.json finns i ~/.pi/agent/, verifiera att apiKey kan lösas, och öppna sedan /model igen.
• Windows rapporterar att Bash inte kan hittas: Installera Git for Windows, eller ställ in shellPath i ~/.pi/agent/settings.json. Snedstreck i JSON måste skrivas två gånger.
• Förfrågan avvisas: Kontrollera att api är openai-completions och att baseUrl slutar på /v1. Aktivera inte ytterligare kompatibilitetsalternativ bara för att tjänsten beskriver sig själv som kompatibel.
• Modell-ID:t är ogiltigt: Kopiera det igen från den aktuella OmniProxy-listan.

Officiella referenser

För installationskommandon, se Pi website och Quickstart. För modellfilen, se Choose a Model och Configuration. För Windows-kommandomiljön, se Run Pi on Windows. För modell-ID:n som används i exemplen, se Gemini model list och xAI models page.

Ersätt varje platshållare med värden från din egen OmniProxy-konfiguration. Publicera aldrig en riktig nyckel.

Ett sparat resultat eller HTTP 200 ensamt bevisar inte fullständig agentkompatibilitet. Kontrollera källa och modell i OmniProxys anropslogg.

Officiella källor · Pi ↗