Instalarea Pi și configurarea OmniProxy

Pi este un mic asistent de terminal—un program care comunică cu tine direct în linia de comandă, citește fișiere și finalizează sarcini. Are un prompt de sistem scurt și doar câteva instrumente în mod implicit. Dacă ai nevoie de alte comenzi, fluxuri de lucru sau interfețe, le poți adăuga ulterior prin extensii. Extensiile sunt componente care adaugă capacități lui Pi și le poți partaja cu alții după ce le creezi.

Subagenții deleagă o parte dintr-o sarcină către un alt asistent, în timp ce modul plan organizează pașii înainte ca execuția să înceapă. Nicio funcție nu este inclusă în mod implicit, dar îi poți cere lui Pi să le construiască sau să instaleze pachete partajate de alții.

Înainte de a începe

macOS și Linux folosesc un script de instalare—o singură comandă care descarcă și instalează automat Pi. Pe Windows, folosește comanda PowerShell furnizată pe pagina principală Pi. PowerShell este mediul de linie de comandă inclus cu Windows. Poți instala Pi și în WSL, mediul Linux disponibil în interiorul Windows.

Dacă alegi să instalezi cu npm, ai nevoie de Node.js 22.19 sau o versiune ulterioară. npm este managerul de pachete folosit cu Node.js și poate instala Pi din linia de comandă.

macOS Linux

install.sh

• curl scriptul oficial
• Instalatorul fixează dependențele
• Actualizează cu pi update

Windows

install.ps1

• Comandă oficială PowerShell
• Git for Windows oferă Bash
• Poți folosi și WSL

Node deja instalat

npm

• Necesită Node 22.19+
• Numele pachetului este pi-coding-agent
• Adaugă --ignore-scripts

Instalare și prima lansare a Pi

Pe macOS sau Linux, deschide un terminal și rulează:

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

Pe Windows, deschide PowerShell și rulează:

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

Dacă Node.js 22.19 sau o versiune ulterioară este deja instalată, poți folosi și comanda alternativă din Quickstart:

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

Scriptul de instalare se poate întrerupe pentru a pune întrebări într-un terminal interactiv. Urmează instrucțiunile de pe ecran pentru a continua. Dacă ai deja o versiune compatibilă de Node, această comandă npm nu va pune întrebări. Pentru a instala Pi într-un alt director, adaugă --prefix /your/directory. La data de 09-10-2026, aceasta a instalat Pi 1.1.0.

O instalare npm normală nu necesită scripturi de ciclu de viață ale dependențelor, care sunt scripturi pe care pachetele le rulează automat în timpul instalării. Scriptul de instalare fixează dependențele; ulterior, actualizează Pi cu pi update. Pentru o instalare npm, folosește metoda de actualizare furnizată de managerul tău de pachete. Utilizatorii Nix ar trebui să instaleze din flake-ul Pi. Un flake este o configurație Nix care descrie software-ul și dependențele sale, iar pi update nu poate actualiza o instalare Nix.

După instalare, confirmă mai întâi că terminalul tău poate găsi Pi:

pi --version

Pe Windows, dacă dorești ca modelele să execute comenzi Bash, instalarea Git for Windows este recomandată pentru majoritatea utilizatorilor locali. Bash este mediul de comandă pe care Pi îl folosește pentru a rula unele comenzi. Pi verifică shellPath setarea în ~/.pi/agent/settings.json, Git Bash sub Program Files, și apoi bash.exe pe PATH, în această ordine. shellPath specifică locația Bash, în timp ce PATH este lista de directoare pe care sistemul le caută pentru comenzi.

După pornirea Pi, poți introduce !printf 'Bash is working\n' pentru a-l verifica. Dacă fișierele și instrumentele tale sunt deja în WSL, instalează Pi în acel mediu Linux urmând Quickstart-ul.

În continuare, intră în folderul pe care dorești ca Pi să îl inspecteze sau la care să lucreze, apoi pornește-l:

cd /path/to/folder
pi

Acest folder devine domeniul de lucru curent al lui Pi. Pi îl folosește pentru a descoperi fișiere și configurații și pentru a grupa sesiunile.

Obținerea valorilor de conexiune de la OmniProxy

Mai întâi, obține aceste trei valori de la 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 este endpoint-ul API către care Pi trimite cereri și trebuie să includă /v1. apiKey este cheia folosită pentru a accesa API-ul. Model ID este numele modelului de apelat și trebuie copiat în întregime din lista curentă de modele OmniProxy.

Setează api la openai-completions, așa cum se arată în exemplul API compatibil. Acest câmp îi spune lui Pi ce format API să folosească atunci când trimite cereri.

Copiază întregul ID al modelului, incluzând orice slash-uri din nume. La data de 09-10-2026, cele două ID-uri de referință din documentația furnizorului au fost gemini-3.8-flash și grok-4.7. Nu copia un nume care nu este prezent în listă.

Introducerea configurației instrumentului

Configurația modelului personalizat la nivel de utilizator a lui Pi este stocată în models.json. Acest fișier se află în directorul agentului, care este implicit ~/.pi/agent, deci calea sa completă este ~/.pi/agent/models.json. Dacă variabila de mediu PI_CODING_AGENT_DIR este setată, Pi folosește directorul specificat de acea variabilă în schimb. O variabilă de mediu este o valoare de configurare furnizată de sistem pentru ca programele să o citească.

Introdu configurația așa cum se arată în exemplul API compatibil:

{
  "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 listează serviciile conectate, în timp ce models listează modelele care pot fi selectate. Fiecare id al modelului trebuie să se potrivească cu ID-ul complet al Modelului din lista curentă de modele OmniProxy. input indică faptul că modelul este configurat aici pentru introducerea textului.

apiKey poate fi introdus ca o valoare literală sau ca $NAME sau ${NAME} astfel încât Pi să o citească dintr-o variabilă de mediu. O valoare care începe cu ! este tratată ca o comandă și executată pentru fiecare cerere. Nu trimite o cheie reală într-un depozit. Dacă gateway-ul nu validează cheile, poți introduce un șir de tip placeholder utilizat doar pe mașina ta locală. La data de 09-10-2026, Pi a citit cu succes fișierul cu această configurație.

Deschiderea /model reîncarcă acest fișier. /model este interfața din Pi pentru vizualizarea și selectarea modelelor. Modelele personalizate nu apar în /model până când Pi nu poate rezolva credențialele lor. După selectarea unui model, apasă Ctrl+S pentru a-l salva ca model implicit pentru sesiuni noi.

Fișier

models.json

• Director implicit: ~/.pi/agent
• Adaugă o intrare sub providers
• Setează api la completions

Adresă

baseUrl

• Include /v1
• apiKey poate referenția o variabilă
• ID-ul modelului trebuie să fie exact

Selectează

/model

• Deschiderea acestuia reîncarcă fișierul
• Selectează modelul pe care tocmai l-ai adăugat
• Ctrl+S îl salvează ca implicit

Verificarea cu o sarcină reală

După finalizarea configurației, poți efectua o verificare non-interactivă într-un director care conține fișiere. Modul non-interactiv înseamnă că Pi finalizează această singură sarcină și apoi iese în loc să intre într-o conversație continuă. Înlocuiește valoarea după --model cu ID-ul complet din lista curentă 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."

Aici, --tools read activează doar instrumentul de citire, iar sarcina instruiește explicit Pi să nu modifice fișierul. La data de 09-10-2026, Pi 1.1.0 a citit cu succes conținutul fișierului. Primul răspuns a durat aproximativ două minute.

Poți folosi și modul interactiv: intră în director, rulează pi, și apoi selectează un model cu /model. Un exemplu de sarcină din Quickstart îi cere lui Pi să explice cum este organizat depozitul și cum să ruleze verificările sale. Observă dacă citește fișierele și oferă o explicație, apoi confirmă sursa și ID-ul modelului în jurnalele de cereri ale OmniProxy.

Lansare

Pi pornește

• Mai întâi cd în folder
• pi --version produce o ieșire
• Numele modelului apare în partea de jos a interfeței

Sarcină

A citit directorul

• Întreabă cum este organizat depozitul
• Revizuiește fișierele pe care le listează
• Nu te baza doar pe o salvare reușită a configurației

Jurnale

Vizibil în gateway

• Sursa este Pi
• ID-ul modelului se potrivește
• Păstrează cheia pe mașina locală

Erori comune

• pi nu poate fi găsit: Redeschide terminalul și încearcă pi --version din nou. Pentru o instalare npm, confirmă că directorul global bin este pe PATH.
• Modelele personalizate nu apar în /model: Confirmă că models.json este în ~/.pi/agent/, verifică dacă apiKey poate fi rezolvat, și apoi redeschide /model.
• Windows raportează că Bash nu poate fi găsit: Instalează Git for Windows sau setează shellPath în ~/.pi/agent/settings.json. Backslash-urile în JSON trebuie scrise de două ori.
• Cererea este respinsă: Verifică dacă api este openai-completions și că baseUrl se termină în /v1. Nu activa opțiuni suplimentare de compatibilitate doar pentru că serviciul se descrie ca fiind compatibil.
• ID-ul modelului este invalid: Copiază-l din nou din lista curentă OmniProxy.

Referințe oficiale

Pentru comenzi de instalare, vezi site-ul Pi și Quickstart. Pentru fișierul de model, vezi Choose a Model și Configuration. Pentru mediul de comandă Windows, vezi Run Pi on Windows. Pentru ID-urile de model folosite în exemple, vezi Gemini model list și xAI models page.

Înlocuiește fiecare spațiu rezervat cu valori din propria ta configurare OmniProxy. Nu publica niciodată o cheie reală.

Un rezultat salvat sau HTTP 200 singur nu dovedește compatibilitatea completă a Agentului. Verifică sursa și modelul în înregistrarea de apeluri OmniProxy.

Surse oficiale · Pi ↗