Pag-install ng Pi at Pag-configure ng OmniProxy

Ang Pi ay isang maliit na terminal assistant—isang program na nakikipag-usap sa iyo nang direkta sa command line, nagbabasa ng mga file, at kumukumpleto ng mga gawain. Mayroon itong maikling system prompt at iilang tool lamang bilang default. Kung kailangan mo ng iba pang mga command, workflow, o interface, maaari mo silang idagdag mamaya sa pamamagitan ng mga extension. Ang mga extension ay mga component na nagdaragdag ng mga kakayahan sa Pi, at maaari mo silang ibahagi sa iba pagkatapos mong gawin ang mga ito.

Ang mga subagent ay nagde-delegate ng bahagi ng isang gawain sa isa pang assistant, habang ang plan mode ay nag-oorganisa ng mga hakbang bago magsimula ang execution. Walang feature na kasama bilang default, ngunit maaari mong hilingin sa Pi na buuin ang mga ito o i-install ang mga package na ibinahagi ng iba.

Bago ka magsimula

Ang macOS at Linux ay gumagamit ng installation script—isang command na awtomatikong nagda-download at nag-i-install ng Pi. Sa Windows, gamitin ang PowerShell command na ibinigay sa homepage ng Pi. Ang PowerShell ay ang command-line environment na kasama sa Windows. Maaari mo ring i-install ang Pi sa WSL, ang Linux environment na available sa loob ng Windows.

Kung pipiliin mong mag-install gamit ang npm, kailangan mo ng Node.js 22.19 o mas bago. Ang npm ay ang package manager na ginagamit sa Node.js at maaaring mag-install ng Pi mula sa command line.

macOS Linux

install.sh

• curl ang opisyal na script
• Ang installer ay nag-pi-pin ng mga dependency
• I-update gamit ang pi update

Windows

install.ps1

• Opisyal na PowerShell command
• Ang Git for Windows ay nagbibigay ng Bash
• Maaari mo ring gamitin ang WSL

Naka-install na ang Node

npm

• Nangangailangan ng Node 22.19+
• Ang pangalan ng package ay pi-coding-agent
• Idagdag ang --ignore-scripts

Pag-install at paglunsad ng Pi sa unang pagkakataon

Sa macOS o Linux, buksan ang terminal at patakbuhin ang:

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

Sa Windows, buksan ang PowerShell at patakbuhin ang:

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

Kung ang Node.js 22.19 o mas bago ay naka-install na, maaari mo ring gamitin ang alternatibong command mula sa Quickstart:

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

Ang installation script ay maaaring huminto para magtanong sa isang interactive terminal. Sundin ang mga prompt sa screen para magpatuloy. Kung mayroon ka nang compatible na bersyon ng Node, ang npm command na ito ay hindi magtatanong. Para i-install ang Pi sa ibang directory, idagdag ang --prefix /your/directory. Noong 2026-10-09, ito ay nag-install ng Pi 1.1.0.

Ang isang normal na npm installation ay hindi nangangailangan ng dependency lifecycle scripts, na mga script na awtomatikong pinapatakbo ng mga package sa panahon ng pag-install. Ang installation script ay nag-pi-pin ng mga dependency; pagkatapos, i-update ang Pi gamit ang pi update. Para sa isang npm installation, gamitin ang update method na ibinigay ng iyong package manager. Ang mga user ng Nix ay dapat mag-install mula sa flake ng Pi. Ang flake ay isang Nix configuration na naglalarawan ng software at mga dependency nito, at ang pi update ay hindi maaaring mag-update ng isang Nix installation.

Pagkatapos ng pag-install, kumpirmahin muna na mahahanap ng iyong terminal ang Pi:

pi --version

Sa Windows, kung gusto mong magpatupad ng mga Bash command ang mga model, inirerekomenda ang pag-install ng Git for Windows para sa karamihan ng mga lokal na user. Ang Bash ay ang command environment na ginagamit ng Pi para magpatakbo ng ilang command. Sinusuri ng Pi ang shellPath setting sa ~/.pi/agent/settings.json, Git Bash sa ilalim ng Program Files, at pagkatapos ay bash.exe sa PATH, sa pagkakasunod-sunod na iyon. shellPath ay tumutukoy sa lokasyon ng Bash, habang ang PATH ay ang listahan ng mga directory na hinahanapan ng system ng mga command.

Pagkatapos simulan ang Pi, maaari mong ipasok ang !printf 'Bash is working\n' para suriin ito. Kung ang iyong mga file at tool ay nasa WSL na, i-install ang Pi sa Linux environment na iyon sa pamamagitan ng pagsunod sa Quickstart.

Susunod, ipasok ang folder na gusto mong i-inspect o pagtrabahuhan ng Pi, at pagkatapos ay simulan ito:

cd /path/to/folder
pi

Ang folder na ito ang nagiging kasalukuyang working scope ng Pi. Ginagamit ito ng Pi para tumuklas ng mga file at configuration at para pangkatin ang mga session.

Kumuha ng mga connection value mula sa OmniProxy

Una, kunin ang tatlong value na ito mula sa 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 ay ang API endpoint kung saan ipinapadala ng Pi ang mga request, at dapat itong magsama ng /v1. apiKey ay ang key na ginagamit para ma-access ang API. Model ID ay ang pangalan ng model na tatawagin at dapat kopyahin nang buo mula sa kasalukuyang listahan ng mga model ng OmniProxy.

I-set ang api sa openai-completions, gaya ng ipinapakita sa compatible API example. Ang field na ito ang nagsasabi sa Pi kung anong API format ang gagamitin kapag nagpapadala ng mga request.

Kopyahin ang buong model ID, kasama ang anumang slash sa pangalan. Noong 2026-10-09, ang dalawang reference ID sa dokumentasyon ng provider ay gemini-3.8-flash at grok-4.7. Huwag kopyahin ang pangalan na wala sa listahan.

Ipasok ang configuration ng tool

Ang user-level custom model configuration ng Pi ay iniimbak sa models.json. Ang file na ito ay matatagpuan sa agent directory, na default sa ~/.pi/agent, kaya ang buong path nito ay ~/.pi/agent/models.json. Kung ang PI_CODING_AGENT_DIR environment variable ay naka-set, ginagamit ng Pi ang directory na tinukoy ng variable na iyon sa halip. Ang environment variable ay isang configuration value na ibinibigay ng system para basahin ng mga program.

Ipasok ang configuration gaya ng ipinapakita sa compatible API example:

{
  "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 ay naglilista ng mga konektadong serbisyo, habang ang models ay naglilista ng mga model na maaaring piliin. Ang bawat id ng model ay dapat tumugma sa kumpletong Model ID sa kasalukuyang listahan ng mga model ng OmniProxy. input ay nagpapahiwatig na ang model ay naka-configure dito para sa text input.

apiKey ay maaaring ipasok bilang literal na value, o bilang $NAME o ${NAME} para basahin ito ng Pi mula sa isang environment variable. Ang value na nagsisimula sa ! ay itinuturing bilang isang command at pinapatakbo para sa bawat request. Huwag mag-commit ng totoong key sa isang repository. Kung hindi i-validate ng gateway ang mga key, maaari kang magpasok ng placeholder string na ginagamit lamang sa iyong lokal na machine. Noong 2026-10-09, matagumpay na nabasa ng Pi ang file gamit ang configuration na ito.

Ang pagbubukas ng /model ay nagre-reload ng file na ito. /model ay ang interface sa Pi para sa pagtingin at pagpili ng mga model. Ang mga custom model ay hindi lumalabas sa /model hanggang sa ma-resolve ng Pi ang kanilang mga credential. Pagkatapos pumili ng model, pindutin ang Ctrl+S para i-save ito bilang default model para sa mga bagong session.

File

models.json

• Default directory: ~/.pi/agent
• Magdagdag ng entry sa ilalim ng providers
• I-set ang api sa completions

Address

baseUrl

• Isama ang /v1
• Ang apiKey ay maaaring mag-reference ng variable
• Ang model id ay dapat eksakto

Piliin

/model

• Ang pagbubukas nito ay nagre-reload ng file
• Piliin ang model na idinagdag mo lang
• Ang Ctrl+S ay nagse-save nito bilang default

I-verify gamit ang isang totoong gawain

Pagkatapos makumpleto ang configuration, maaari kang magsagawa ng non-interactive check sa isang directory na naglalaman ng mga file. Ang non-interactive mode ay nangangahulugan na kinukumpleto ng Pi ang iisang gawaing ito at pagkatapos ay lalabas sa halip na pumasok sa isang patuloy na usapan. Palitan ang value pagkatapos ng --model ng kumpletong ID mula sa kasalukuyang listahan ng 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."

Dito, --tools read ay nagpapagana lamang ng read tool, at ang gawain ay tahasan ding nag-uutos sa Pi na huwag baguhin ang file. Noong 2026-10-09, matagumpay na nabasa ng Pi 1.1.0 ang mga nilalaman ng file. Ang unang tugon ay tumagal ng mga dalawang minuto.

Maaari mo ring gamitin ang interactive mode: pumasok sa directory, patakbuhin ang pi, at pagkatapos ay pumili ng model gamit ang /model. Ang isang halimbawa ng gawain sa Quickstart ay humihiling sa Pi na ipaliwanag kung paano naka-organisa ang repository at kung paano patakbuhin ang mga check nito. Obserbahan kung binabasa nito ang mga file at nagbibigay ng paliwanag, pagkatapos ay kumpirmahin ang source at model ID sa mga request log ng OmniProxy.

Ilunsad

Inilunsad ang pi

• Mag-cd muna sa folder
• Ang pi --version ay naglalabas ng output
• Ang pangalan ng model ay lumalabas sa ibaba ng interface

Gawain

Binasa nito ang directory

• Magtanong kung paano naka-organisa ang repository
• Suriin ang mga file na inilista nito
• Huwag umasa lamang sa matagumpay na configuration save

Mga Log

Nakikita sa gateway

• Ang source ay Pi
• Ang Model ID ay tumutugma
• Panatilihin ang key sa lokal na machine

Mga karaniwang error

• pi ay hindi mahanap: Buksan muli ang terminal at subukan muli ang pi --version . Para sa isang npm installation, kumpirmahin na ang global bin directory ay nasa PATH.
• Ang mga custom model ay hindi lumalabas sa /model: Kumpirmahin na ang models.json ay nasa ~/.pi/agent/, i-verify na ang apiKey ay maaaring ma-resolve, at pagkatapos ay buksan muli ang /model.
• Nag-uulat ang Windows na hindi mahanap ang Bash: I-install ang Git for Windows, o i-set ang shellPath sa ~/.pi/agent/settings.json. Ang mga backslash sa JSON ay dapat isulat nang dalawang beses.
• Ang request ay tinanggihan: Suriin na ang api ay openai-completions at na ang baseUrl ay nagtatapos sa /v1. Huwag paganahin ang mga karagdagang compatibility option dahil lamang sa inilalarawan ng serbisyo ang sarili nito bilang compatible.
• Hindi valid ang model ID: Kopyahin itong muli mula sa kasalukuyang listahan ng OmniProxy.

Mga opisyal na sanggunian

Para sa mga installation command, tingnan ang Pi website at Quickstart. Para sa model file, tingnan ang Choose a Model at Configuration. Para sa Windows command environment, tingnan ang Run Pi on Windows. Para sa mga model ID na ginamit sa mga halimbawa, tingnan ang Gemini model list at xAI models page.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · Pi ↗