Инсталација Pi-ја и конфигурација OmniProxy-а

Pi је мали терминалски асистент — програм који разговара са вама директно у командној линији, чита датотеке и завршава задатке. Има кратак системски упит и подразумевано само неколико алата. Ако су вам потребне друге команде, радни токови или интерфејси, можете их касније додати кроз екстензије. Екстензије су компоненте које додају могућности Pi-ју, а можете их делити са другима након што их креирате.

Подагенти делегирају део задатка другом асистенту, док режим планирања организује кораке пре почетка извршавања. Ниједна функција није укључена подразумевано, али можете тражити од Pi-ја да их изгради или инсталирати пакете које деле други.

Пре почетка

macOS и Linux користе инсталациону скрипту — једну команду која аутоматски преузима и инсталира Pi. На Windows-у, користите PowerShell команду наведену на почетној страници Pi-ја. PowerShell је командно окружење укључено у Windows. Pi такође можете инсталирати у WSL-у, Linux окружењу доступном унутар Windows-а.

Ако одлучите да инсталирате са npm, потребан вам је Node.js 22.19 или новији. npm је менаџер пакета који се користи са Node.js-ом и може инсталирати Pi из командне линије.

macOS Linux

install.sh

curl званичну скрипту
Инсталер фиксира зависности
Ажурирајте са pi update

Windows

install.ps1

Званична PowerShell команда
Git for Windows обезбеђује Bash
Такође можете користити WSL

Node је већ инсталиран

npm

Захтева Node 22.19+
Име пакета је pi-coding-agent
Додајте --ignore-scripts

Инсталациона скрипта фиксира зависности. npm инсталација не фиксира транзитивне зависности и захтева --ignore-scripts.

Инсталација и прво покретање Pi-ја

На macOS-у или Linux-у, отворите терминал и покрените:

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

На Windows-у, отворите PowerShell и покрените:

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

Ако је Node.js 22.19 или новији већ инсталиран, можете користити и алтернативну команду из Quickstart-а:

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

Инсталациона скрипта може паузирати да би поставила питања у интерактивном терминалу. Пратите упутства на екрану да бисте наставили. Ако већ имате компатибилну верзију Node-а, ова npm команда неће постављати питања. Да бисте инсталирали Pi у другом директоријуму, додајте --prefix /your/directory. Дана 09.10.2026, ово је инсталирало Pi 1.1.0.

Нормална npm инсталација не захтева скрипте животног циклуса зависности, које су скрипте које пакети аутоматски покрећу током инсталације. Инсталациона скрипта фиксира зависности; након тога, ажурирајте Pi са pi update. За npm инсталацију, користите метод ажурирања који пружа ваш менаџер пакета. Nix корисници треба да инсталирају из Pi-јевог flake-а. Flake је Nix конфигурација која описује софтвер и његове зависности, а pi update не може ажурирати Nix инсталацију.

Након инсталације, прво потврдите да ваш терминал може пронаћи Pi:

pi --version

На Windows-у, ако желите да модели извршавају Bash команде, инсталирање Git for Windows се препоручује за већину локалних корисника. Bash је командно окружење које Pi користи за покретање неких команди. Pi проверава shellPath подешавање у ~/.pi/agent/settings.json, Git Bash под Program Files, а затим bash.exe на PATH-у, тим редом. shellPath наводи локацију Bash-а, док је PATH листа директоријума које систем претражује за команде.

Након покретања Pi-ја, можете унети !printf 'Bash is working\n' да бисте га проверили. Ако су ваше датотеке и алати већ у WSL-у, инсталирајте Pi у том Linux окружењу пратећи Quickstart.

Затим, уђите у фолдер који желите да Pi прегледа или на којем желите да ради, а затим га покрените:

cd /path/to/folder
pi

Овај фолдер постаје тренутни радни опсег Pi-ја. Pi га користи за откривање датотека и конфигурације и за груписање сесија.

Добијање вредности за повезивање из OmniProxy-а

Прво, прибавите ове три вредности из 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 је API endpoint на који Pi шаље захтеве и мора укључивати /v1. apiKey је кључ који се користи за приступ API-ју. Model ID је име модела за позивање и мора се копирати у потпуности са тренутне листе модела OmniProxy-а.

Поставите api на openai-completions, као што је приказано у примеру компатибилног API-ја. Ово поље говори Pi-ју који API формат да користи приликом слања захтева.

Копирајте цео ID модела, укључујући све косе црте у имену. Дана 09.10.2026, два референтна ID-а у документацији провајдера су била gemini-3.8-flash и grok-4.7. Немојте копирати име које није присутно на листи.

Унос конфигурације алата

Конфигурација прилагођеног модела на нивоу корисника за Pi се чува у models.json. Ова датотека се налази у директоријуму агента, који је подразумевано ~/.pi/agent, тако да је њена пуна путања ~/.pi/agent/models.json. Ако је PI_CODING_AGENT_DIR променљива окружења подешена, Pi користи директоријум наведен том променљивом уместо тога. Променљива окружења је конфигурациона вредност коју систем пружа програмима за читање.

Унесите конфигурацију као што је приказано у примеру компатибилног 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 наводи повезане сервисе, док models наводи моделе који се могу изабрати. Сваки модел id мора се поклапати са пуним ID-ом модела на тренутној листи OmniProxy-а. input означава да је модел овде конфигурисан за текстуални унос.

apiKey се може унети као литерална вредност, или као $NAME или ${NAME} тако да је Pi чита из променљиве окружења. Вредност која почиње са ! се третира као команда и извршава за сваки захтев. Немојте уносити прави кључ у репозиторијум. Ако gateway не потврђује кључеве, можете унети placeholder стринг који се користи само на вашој локалној машини. Дана 09.10.2026, Pi је успешно прочитао датотеку са овом конфигурацијом.

Отварање /model поново учитава ову датотеку. /model је интерфејс у Pi-ју за преглед и одабир модела. Прилагођени модели се не појављују у /model док Pi не успе да разреши њихове акредитиве. Након одабира модела, притисните Ctrl+S да бисте га сачували као подразумевани модел за нове сесије.

Датотека

models.json

Подразумевани директоријум: ~/.pi/agent
Додајте унос под providers
Поставите api на completions

Адреса

baseUrl

Укључите /v1
apiKey може референцирати променљиву
ID модела мора бити тачан

Изаберите

/model

Отварање поново учитава датотеку
Изаберите модел који сте управо додали
Ctrl+S га чува као подразумевани

Након уређивања датотеке, отворите /model у Pi-ју и потврдите да се модели појављују.

Верификација стварног задатка

Након завршетка конфигурације, можете извршити неинтерактивну проверу у директоријуму који садржи датотеке. Неинтерактивни режим значи да Pi завршава овај један задатак и затим излази уместо да улази у текући разговор. Замените вредност након --model пуним ID-ом са тренутне 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."

Овде, --tools read омогућава само алат за читање, а задатак такође експлицитно упућује Pi да не мења датотеку. Дана 09.10.2026, Pi 1.1.0 је успешно прочитао садржај датотеке. Први одговор је трајао око два минута.

Такође можете користити интерактивни режим: уђите у директоријум, покрените pi, а затим изаберите модел са /model. Један пример задатка у Quickstart-у тражи од Pi-ја да објасни како је репозиторијум организован и како покренути његове провере. Посматрајте да ли чита датотеке и пружа објашњење, затим потврдите извор и ID модела у логовима захтева OmniProxy-а.

Покретање

pi се покреће

Прво cd у фолдер
pi --version даје излаз
Име модела се појављује на дну интерфејса

Задатак

Прочитао је директоријум

Питајте како је репозиторијум организован
Прегледајте датотеке које наводи
Не ослањајте се само на успешно чување конфигурације

Логови

Видљиво у gateway-у

Извор је Pi
ID модела се поклапа
Задржите кључ на локалној машини

Након што се име модела појави на дну интерфејса, завршите и један стварни задатак.

Уобичајене грешке

pi се не може пронаћи: Поново отворите терминал и покушајте pi --version поново. За npm инсталацију, потврдите да је глобални bin директоријум на PATH-у.
Прилагођени модели се не појављују у /model: Потврдите да је models.json у ~/.pi/agent/, проверите да ли се apiKey може разрешити, а затим поново отворите /model.
Windows пријављује да се Bash не може пронаћи: Инсталирајте Git for Windows, или подесите shellPath у ~/.pi/agent/settings.json. Косе црте уназад у JSON-у морају бити написане двапут.
Захтев је одбијен: Проверите да ли је api подешено на openai-completions и да се baseUrl завршава са /v1. Немојте омогућавати додатне опције компатибилности само зато што се сервис описује као компатибилан.
ID модела је неважећи: Копирајте га поново са тренутне OmniProxy листе.

Званичне референце

За команде инсталације, погледајте Pi website и Quickstart. За датотеку модела, погледајте Choose a Model и Configuration. За командно окружење Windows-а, погледајте Run Pi on Windows. За ID-ове модела коришћене у примерима, погледајте Gemini model list и xAI models page.

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

Сачувани резултат или HTTP 200 сами по себи не доказују пуну компатибилност Агента. Проверите извор и модел у запису позива OmniProxy.

Званични извори · Pi ↗