Inštalácia Pi a konfigurácia OmniProxy

Pi je malý terminálový asistent – program, ktorý s vami komunikuje priamo v príkazovom riadku, číta súbory a plní úlohy. Má krátky systémový prompt a v predvolenom nastavení len niekoľko nástrojov. Ak potrebujete ďalšie príkazy, pracovné postupy alebo rozhrania, môžete ich neskôr pridať prostredníctvom rozšírení. Rozšírenia sú komponenty, ktoré pridávajú do Pi nové schopnosti, a po ich vytvorení ich môžete zdieľať s ostatnými.

Podasistenti delegujú časť úlohy na iného asistenta, zatiaľ čo režim plánovania organizuje kroky ešte pred začiatkom vykonávania. Ani jedna z týchto funkcií nie je súčasťou predvolenej inštalácie, ale môžete požiadať Pi, aby ich vytvoril, alebo nainštalovať balíčky zdieľané inými používateľmi.

Skôr než začnete

Systémy macOS a Linux používajú inštalačný skript – jediný príkaz, ktorý automaticky stiahne a nainštaluje Pi. V systéme Windows použite príkaz PowerShell uvedený na domovskej stránke Pi. PowerShell je prostredie príkazového riadka, ktoré je súčasťou systému Windows. Pi môžete nainštalovať aj v WSL, čo je linuxové prostredie dostupné v rámci systému Windows.

Ak sa rozhodnete pre inštaláciu pomocou npm, potrebujete Node.js 22.19 alebo novší. npm je správca balíčkov používaný s Node.js a dokáže nainštalovať Pi z príkazového riadka.

macOS Linux

install.sh

• curl oficiálneho skriptu
• Inštalátor zafixuje závislosti
• Aktualizácia pomocou pi update

Windows

install.ps1

• Oficiálny príkaz PowerShell
• Git for Windows poskytuje Bash
• Môžete použiť aj WSL

Node je už nainštalovaný

npm

• Vyžaduje Node 22.19+
• Názov balíčka je pi-coding-agent
• Pridajte --ignore-scripts

Inštalácia a prvé spustenie Pi

Na systémoch macOS alebo Linux otvorte terminál a spustite:

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

Vo Windows otvorte PowerShell a spustite:

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

Ak už máte nainštalovaný Node.js 22.19 alebo novší, môžete použiť aj alternatívny príkaz z rýchleho štartu (Quickstart):

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

Inštalačný skript sa môže pozastaviť a položiť otázky v interaktívnom termináli. Postupujte podľa pokynov na obrazovke. Ak už máte kompatibilnú verziu Node, tento príkaz npm sa na nič pýtať nebude. Ak chcete nainštalovať Pi do iného adresára, pridajte --prefix /your/directory. K 9. 10. 2026 bola nainštalovaná verzia Pi 1.1.0.

Bežná inštalácia cez npm nevyžaduje skripty životného cyklu závislostí, čo sú skripty, ktoré balíčky spúšťajú automaticky počas inštalácie. Inštalačný skript závislosti fixuje; následne Pi aktualizujte pomocou pi update. Pri inštalácii cez npm použite metódu aktualizácie poskytovanú vaším správcom balíčkov. Používatelia Nix by mali inštalovať z flake balíčka Pi. Flake je konfigurácia Nix, ktorá popisuje softvér a jeho závislosti, a pi update nedokáže aktualizovať inštaláciu Nix.

Po inštalácii najprv overte, či váš terminál dokáže nájsť Pi:

pi --version

Ak chcete, aby modely vo Windows vykonávali príkazy Bash, väčšine lokálnych používateľov odporúčame nainštalovať Git for Windows. Bash je príkazové prostredie, ktoré Pi používa na spúšťanie niektorých príkazov. Pi kontroluje nastavenie shellPath v ~/.pi/agent/settings.json, Git Bash v priečinku Program Files a následne bash.exe v PATH, a to v tomto poradí. shellPath určuje umiestnenie Bashu, zatiaľ čo PATH je zoznam adresárov, v ktorých systém vyhľadáva príkazy.

Po spustení Pi môžete zadať !printf 'Bash is working\n' na kontrolu. Ak sú vaše súbory a nástroje už v WSL, nainštalujte Pi v tomto linuxovom prostredí podľa rýchleho štartu.

Ďalej prejdite do priečinka, ktorý má Pi analyzovať alebo v ktorom má pracovať, a potom ho spustite:

cd /path/to/folder
pi

Tento priečinok sa stane aktuálnym pracovným rozsahom Pi. Pi ho používa na vyhľadávanie súborov a konfigurácie a na zoskupovanie relácií.

Získanie pripojovacích hodnôt z OmniProxy

Najprv získajte tieto tri hodnoty z 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 koncový bod API, na ktorý Pi odosiela požiadavky, a musí obsahovať /v1. apiKey je kľúč používaný na prístup k API. Model ID je názov modelu, ktorý sa má volať, a musí byť skopírovaný v plnom znení z aktuálneho zoznamu modelov OmniProxy.

Nastavte api na openai-completions, ako je znázornené v príklade kompatibilného API. Toto pole hovorí Pi, aký formát API má použiť pri odosielaní požiadaviek.

Skopírujte celý identifikátor modelu vrátane všetkých lomiek v názve. K 9. 10. 2026 boli dva referenčné identifikátory v dokumentácii poskytovateľa gemini-3.8-flash a grok-4.7. Nekopírujte názov, ktorý sa v zozname nenachádza.

Zadanie konfigurácie nástroja

Konfigurácia vlastného modelu na úrovni používateľa v Pi je uložená v models.json. Tento súbor sa nachádza v adresári agenta, ktorý je predvolene ~/.pi/agent, takže jeho úplná cesta je ~/.pi/agent/models.json. Ak je nastavená premenná prostredia PI_CODING_AGENT_DIR, Pi namiesto toho použije adresár určený touto premennou. Premenná prostredia je konfiguračná hodnota poskytnutá systémom, ktorú programy čítajú.

Zadajte konfiguráciu tak, ako je znázornené v príklade kompatibilného 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 uvádza pripojené služby, zatiaľ čo models uvádza modely, ktoré možno vybrať. id každého modelu sa musí zhodovať s úplným identifikátorom modelu v aktuálnom zozname modelov OmniProxy. input označuje, že model je tu nakonfigurovaný na textový vstup.

apiKey možno zadať ako literálnu hodnotu alebo ako $NAME či ${NAME}, aby ju Pi načítal z premennej prostredia. Hodnota začínajúca na ! sa považuje za príkaz a vykoná sa pri každej požiadavke. Do úložiska (repozitára) neukladajte skutočný kľúč. Ak brána (gateway) kľúče neoveruje, môžete zadať zástupný reťazec, ktorý sa používa iba na vašom lokálnom počítači. K 9. 10. 2026 Pi úspešne načítal súbor s touto konfiguráciou.

Otvorenie /model znova načíta tento súbor. /model je rozhranie v Pi na prezeranie a výber modelov. Vlastné modely sa v /model nezobrazia, kým Pi nedokáže vyriešiť ich poverenia. Po výbere modelu stlačte Ctrl+S, čím ho uložíte ako predvolený model pre nové relácie.

Súbor

models.json

• Predvolený adresár: ~/.pi/agent
• Pridajte záznam pod providers
• Nastavte api na completions

Adresa

baseUrl

• Zahrňte /v1
• apiKey môže odkazovať na premennú
• Identifikátor modelu musí byť presný

Vybrať

/model

• Otvorenie znova načíta súbor
• Vyberte model, ktorý ste práve pridali
• Ctrl+S ho uloží ako predvolený

Overenie pomocou skutočnej úlohy

Po dokončení konfigurácie môžete vykonať neinteraktívnu kontrolu v adresári obsahujúcom súbory. Neinteraktívny režim znamená, že Pi dokončí túto jednu úlohu a potom sa ukončí namiesto toho, aby vstúpil do prebiehajúcej konverzácie. Nahraďte hodnotu za --model úplným identifikátorom z aktuálneho zoznamu 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."

Tu --tools read povoľuje iba nástroj na čítanie a úloha tiež výslovne inštruuje Pi, aby súbor neupravoval. K 9. 10. 2026 Pi 1.1.0 úspešne prečítal obsah súboru. Prvá odpoveď trvala približne dve minúty.

Môžete použiť aj interaktívny režim: prejdite do adresára, spustite pi a potom vyberte model pomocou /model. Jeden príklad úlohy v rýchlom štarte žiada Pi, aby vysvetlil, ako je repozitár organizovaný a ako spustiť jeho kontroly. Sledujte, či číta súbory a poskytuje vysvetlenie, a potom potvrďte zdroj a identifikátor modelu v protokoloch požiadaviek OmniProxy.

Spustiť

pi sa spustí

• Najprv cd do priečinka
• pi --version vytvorí výstup
• Názov modelu sa zobrazí v spodnej časti rozhrania

Úloha

Prečítal adresár

• Opýtajte sa, ako je repozitár organizovaný
• Skontrolujte súbory, ktoré vypíše
• Nespoliehajte sa len na úspešné uloženie konfigurácie

Protokoly

Viditeľné v bráne

• Zdrojom je Pi
• Identifikátor modelu sa zhoduje
• Kľúč ponechajte na lokálnom počítači

Bežné chyby

• pi nemožno nájsť: Znova otvorte terminál a skúste pi --version znova. Pri inštalácii cez npm potvrďte, že globálny binárny adresár je v PATH.
• Vlastné modely sa nezobrazujú v /model: Potvrďte, že models.json je v ~/.pi/agent/, overte, či možno apiKey vyriešiť, a potom znova otvorte /model.
• Windows hlási, že Bash nemožno nájsť: Nainštalujte Git for Windows alebo nastavte shellPath v ~/.pi/agent/settings.json. Spätné lomky v JSON musia byť napísané dvakrát.
• Požiadavka je zamietnutá: Skontrolujte, či je api nastavené na openai-completions a či baseUrl končí na /v1. Nepovoľujte ďalšie možnosti kompatibility len preto, že sa služba opisuje ako kompatibilná.
• Identifikátor modelu je neplatný: Skopírujte ho znova z aktuálneho zoznamu OmniProxy.

Oficiálne referencie

Inštalačné príkazy nájdete na webovej stránke Pi a v rýchlom štarte. Informácie o súbore modelu nájdete v časti Výber modelu a Konfigurácia. Informácie o príkazovom prostredí systému Windows nájdete v časti Spustenie Pi vo Windows. Identifikátory modelov použité v príkladoch nájdete v zozname modelov Gemini a na stránke modelov xAI.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · Pi ↗