Instalace Pi a konfigurace OmniProxy

Pi je malý terminálový asistent – program, který s vámi komunikuje přímo v příkazovém řádku, čte soubory a plní úkoly. Má krátký systémový prompt a ve výchozím stavu jen několik málo nástrojů. Pokud potřebujete další příkazy, pracovní postupy nebo rozhraní, můžete je později přidat pomocí rozšíření. Rozšíření jsou komponenty, které rozšiřují schopnosti Pi, a po jejich vytvoření je můžete sdílet s ostatními.

Podřízení agenti (subagents) delegují část úkolu na jiného asistenta, zatímco režim plánování (plan mode) organizuje kroky před zahájením samotného provádění. Ani jedna z těchto funkcí není ve výchozím nastavení zahrnuta, ale můžete požádat Pi, aby je vytvořilo, nebo nainstalovat balíčky sdílené ostatními.

Než začnete

macOS a Linux používají instalační skript – jediný příkaz, který automaticky stáhne a nainstaluje Pi. Ve Windows použijte příkaz PowerShellu uvedený na domovské stránce Pi. PowerShell je prostředí příkazového řádku, které je součástí Windows. Pi můžete nainstalovat také ve WSL, což je linuxové prostředí dostupné v rámci Windows.

Pokud se rozhodnete pro instalaci pomocí npm, potřebujete Node.js 22.19 nebo novější. npm je správce balíčků používaný v Node.js a dokáže nainstalovat Pi z příkazového řádku.

macOS Linux

install.sh

• curl oficiálního skriptu
• Instalátor zafixuje závislosti
• Aktualizace pomocí pi update

Windows

install.ps1

• Oficiální příkaz pro PowerShell
• Git for Windows poskytuje Bash
• Můžete také použít WSL

Node je již nainstalován

npm

• Vyžaduje Node 22.19+
• Název balíčku je pi-coding-agent
• Přidejte --ignore-scripts

Instalace a první spuštění Pi

Na macOS nebo Linuxu otevřete terminál a spusťte:

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

Ve Windows otevřete PowerShell a spusťte:

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

Pokud již máte nainstalovaný Node.js 22.19 nebo novější, můžete také použít alternativní příkaz z rychlého startu (Quickstart):

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

Instalační skript se může v interaktivním terminálu zastavit a položit vám otázky. Pro pokračování postupujte podle pokynů na obrazovce. Pokud již máte kompatibilní verzi Node, tento příkaz npm se na nic ptát nebude. Chcete-li nainstalovat Pi do jiného adresáře, přidejte --prefix /your/directory. K datu 9. 10. 2026 byla takto nainstalována verze Pi 1.1.0.

Běžná instalace přes npm nevyžaduje skripty životního cyklu závislostí, což jsou skripty, které balíčky spouštějí automaticky během instalace. Instalační skript závislosti zafixuje; poté Pi aktualizujte pomocí pi update. Pro instalaci přes npm použijte metodu aktualizace poskytovanou vaším správcem balíčků. Uživatelé Nix by měli instalovat z Pi flake. Flake je konfigurace Nix, která popisuje software a jeho závislosti, a pi update nemůže aktualizovat instalaci Nix.

Po instalaci nejprve ověřte, že váš terminál dokáže najít Pi:

pi --version

Pokud chcete, aby modely ve Windows spouštěly příkazy Bash, doporučuje se většině místních uživatelů nainstalovat Git for Windows. Bash je příkazové prostředí, které Pi používá ke spouštění některých příkazů. Pi kontroluje shellPath nastavení v ~/.pi/agent/settings.json, Git Bash v Program Files a poté bash.exe v PATH, v tomto pořadí. shellPath specifikuje umístění Bashe, zatímco PATH je seznam adresářů, ve kterých systém vyhledává příkazy.

Po spuštění Pi můžete zadat !printf 'Bash is working\n' pro kontrolu. Pokud jsou vaše soubory a nástroje již ve WSL, nainstalujte Pi v tomto linuxovém prostředí podle rychlého startu.

Dále přejděte do složky, kterou má Pi prozkoumat nebo na které má pracovat, a poté jej spusťte:

cd /path/to/folder
pi

Tato složka se stane aktuálním pracovním rozsahem Pi. Pi ji používá k vyhledávání souborů a konfigurace a ke seskupování relací.

Získání hodnot připojení z OmniProxy

Nejprve získejte tyto tři 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 který Pi odesílá požadavky, a musí obsahovat /v1. apiKey je klíč používaný pro přístup k API. Model ID je název modelu, který se má volat, a musí být zkopírován v plném znění z aktuálního seznamu modelů OmniProxy.

Nastavte api na openai-completions, jak je znázorněno v příkladu kompatibilního API. Toto pole říká Pi, jaký formát API má při odesílání požadavků použít.

Zkopírujte celé ID modelu, včetně všech lomítek v názvu. K datu 9. 10. 2026 byla dvě referenční ID v dokumentaci poskytovatele gemini-3.8-flash a grok-4.7. Nekopírujte název, který v seznamu není.

Zadání konfigurace nástroje

Uživatelská konfigurace vlastních modelů v Pi je uložena v models.json. Tento soubor se nachází v adresáři agenta, který je standardně ~/.pi/agent, takže jeho úplná cesta je ~/.pi/agent/models.json. Pokud je nastavena proměnná prostředí PI_CODING_AGENT_DIR , Pi místo toho použije adresář určený touto proměnnou. Proměnná prostředí je konfigurační hodnota poskytovaná systémem, kterou programy čtou.

Zadejte konfiguraci podle příkladu 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ádí připojené služby, zatímco models uvádí modely, které lze vybrat. id každého modelu se musí shodovat s úplným ID modelu v aktuálním seznamu modelů OmniProxy. input označuje, že model je zde nakonfigurován pro textový vstup.

apiKey lze zadat jako doslovnou hodnotu, nebo jako $NAME nebo ${NAME} , takže ji Pi načte z proměnné prostředí. Hodnota začínající ! je považována za příkaz a spuštěna pro každý požadavek. Neukládejte skutečný klíč do repozitáře. Pokud brána klíče neověřuje, můžete zadat zástupný řetězec používaný pouze na vašem místním počítači. K datu 9. 10. 2026 Pi úspěšně přečetlo soubor s touto konfigurací.

Otevření /model znovu načte tento soubor. /model je rozhraní v Pi pro prohlížení a výběr modelů. Vlastní modely se v /model nezobrazí, dokud Pi nedokáže vyřešit jejich přihlašovací údaje. Po výběru modelu stiskněte Ctrl+S pro uložení jako výchozího modelu pro nové relace.

Soubor

models.json

• Výchozí adresář: ~/.pi/agent
• Přidejte záznam pod providers
• Nastavte api na completions

Adresa

baseUrl

• Zahrňte /v1
• apiKey může odkazovat na proměnnou
• ID modelu musí být přesné

Vybrat

/model

• Otevřením se soubor znovu načte
• Vyberte model, který jste právě přidali
• Ctrl+S jej uloží jako výchozí

Ověření pomocí skutečného úkolu

Po dokončení konfigurace můžete provést neinteraktivní kontrolu v adresáři obsahujícím soubory. Neinteraktivní režim znamená, že Pi splní tento jediný úkol a poté ukončí činnost, místo aby vstoupilo do probíhající konverzace. Nahraďte hodnotu za --model úplným ID z aktuálního seznamu 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."

Zde --tools read povoluje pouze nástroj pro čtení a úkol také výslovně instruuje Pi, aby soubor neupravovalo. K datu 9. 10. 2026 Pi 1.1.0 úspěšně přečetlo obsah souboru. První odpověď trvala asi dvě minuty.

Můžete také použít interaktivní režim: přejděte do adresáře, spusťte pi, a poté vyberte model pomocí /model. Jeden příklad úkolu v rychlém startu žádá Pi, aby vysvětlilo, jak je repozitář organizován a jak spustit jeho kontroly. Sledujte, zda čte soubory a poskytuje vysvětlení, poté potvrďte zdroj a ID modelu v protokolech požadavků OmniProxy.

Spustit

pi se spustí

• Nejprve cd do složky
• pi --version vytvoří výstup
• Název modelu se zobrazí v dolní části rozhraní

Úkol

Přečetlo adresář

• Zeptejte se, jak je repozitář organizován
• Zkontrolujte soubory, které vypíše
• Nespoléhejte pouze na úspěšné uložení konfigurace

Protokoly

Viditelné v bráně

• Zdroj je Pi
• ID modelu se shoduje
• Uchovávejte klíč na místním počítači

Časté chyby

• pi nelze nalézt: Znovu otevřete terminál a zkuste pi --version znovu. U instalace přes npm potvrďte, že globální adresář bin je v PATH.
• Vlastní modely se nezobrazují v /model: Potvrďte, že models.json je v ~/.pi/agent/, ověřte, že apiKey lze vyřešit, a poté znovu otevřete /model.
• Windows hlásí, že Bash nelze nalézt: Nainstalujte Git for Windows nebo nastavte shellPath v ~/.pi/agent/settings.json. Zpětná lomítka v JSON musí být napsána dvakrát.
• Požadavek je zamítnut: Zkontrolujte, zda api je openai-completions a že baseUrl končí na /v1. Nepovolujte další možnosti kompatibility jen proto, že se služba popisuje jako kompatibilní.
• ID modelu je neplatné: Zkopírujte jej znovu z aktuálního seznamu OmniProxy.

Oficiální reference

Pro instalační příkazy viz web Pi a Rychlý start. Pro soubor modelu viz Výběr modelu a Konfigurace. Pro příkazové prostředí Windows viz Spuštění Pi ve Windows. Pro ID modelů použitá v příkladech viz seznam modelů Gemini a stránka modelů xAI.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · Pi ↗