Pi ਇੰਸਟਾਲ ਕਰਨਾ ਅਤੇ OmniProxy ਕੌਂਫਿਗਰ ਕਰਨਾ

Pi ਇੱਕ ਛੋਟਾ ਟਰਮੀਨਲ ਸਹਾਇਕ ਹੈ—ਇੱਕ ਪ੍ਰੋਗਰਾਮ ਜੋ ਤੁਹਾਡੇ ਨਾਲ ਸਿੱਧਾ ਕਮਾਂਡ ਲਾਈਨ ਵਿੱਚ ਗੱਲ ਕਰਦਾ ਹੈ, ਫਾਈਲਾਂ ਪੜ੍ਹਦਾ ਹੈ, ਅਤੇ ਕੰਮ ਪੂਰੇ ਕਰਦਾ ਹੈ। ਇਸ ਵਿੱਚ ਇੱਕ ਛੋਟਾ ਸਿਸਟਮ ਪ੍ਰੋਂਪਟ ਹੈ ਅਤੇ ਡਿਫੌਲਟ ਰੂਪ ਵਿੱਚ ਸਿਰਫ਼ ਕੁਝ ਟੂਲ ਹਨ। ਜੇਕਰ ਤੁਹਾਨੂੰ ਹੋਰ ਕਮਾਂਡਾਂ, ਵਰਕਫਲੋ ਜਾਂ ਇੰਟਰਫੇਸ ਦੀ ਲੋੜ ਹੈ, ਤਾਂ ਤੁਸੀਂ ਉਹਨਾਂ ਨੂੰ ਬਾਅਦ ਵਿੱਚ ਐਕਸਟੈਂਸ਼ਨਾਂ ਰਾਹੀਂ ਜੋੜ ਸਕਦੇ ਹੋ। ਐਕਸਟੈਂਸ਼ਨ ਉਹ ਕੰਪੋਨੈਂਟ ਹਨ ਜੋ Pi ਵਿੱਚ ਸਮਰੱਥਾਵਾਂ ਜੋੜਦੇ ਹਨ, ਅਤੇ ਤੁਸੀਂ ਉਹਨਾਂ ਨੂੰ ਬਣਾਉਣ ਤੋਂ ਬਾਅਦ ਦੂਜਿਆਂ ਨਾਲ ਸਾਂਝਾ ਕਰ ਸਕਦੇ ਹੋ।

ਸਬ-ਏਜੰਟ (Subagents) ਕਿਸੇ ਕੰਮ ਦਾ ਕੁਝ ਹਿੱਸਾ ਕਿਸੇ ਹੋਰ ਸਹਾਇਕ ਨੂੰ ਸੌਂਪਦੇ ਹਨ, ਜਦੋਂ ਕਿ ਪਲਾਨ ਮੋਡ ਐਗਜ਼ੀਕਿਊਸ਼ਨ ਸ਼ੁਰੂ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਕਦਮਾਂ ਨੂੰ ਵਿਵਸਥਿਤ ਕਰਦਾ ਹੈ। ਕੋਈ ਵੀ ਵਿਸ਼ੇਸ਼ਤਾ ਡਿਫੌਲਟ ਰੂਪ ਵਿੱਚ ਸ਼ਾਮਲ ਨਹੀਂ ਹੈ, ਪਰ ਤੁਸੀਂ Pi ਨੂੰ ਉਹਨਾਂ ਨੂੰ ਬਣਾਉਣ ਲਈ ਕਹਿ ਸਕਦੇ ਹੋ ਜਾਂ ਦੂਜਿਆਂ ਦੁਆਰਾ ਸਾਂਝੇ ਕੀਤੇ ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰ ਸਕਦੇ ਹੋ।

ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

macOS ਅਤੇ Linux ਇੱਕ ਇੰਸਟਾਲੇਸ਼ਨ ਸਕ੍ਰਿਪਟ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ—ਇੱਕ ਸਿੰਗਲ ਕਮਾਂਡ ਜੋ Pi ਨੂੰ ਆਪਣੇ ਆਪ ਡਾਊਨਲੋਡ ਅਤੇ ਇੰਸਟਾਲ ਕਰਦੀ ਹੈ। Windows ’ਤੇ, Pi ਹੋਮਪੇਜ ’ਤੇ ਪ੍ਰਦਾਨ ਕੀਤੀ ਗਈ PowerShell ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰੋ। PowerShell Windows ਦੇ ਨਾਲ ਸ਼ਾਮਲ ਕਮਾਂਡ-ਲਾਈਨ ਵਾਤਾਵਰਣ ਹੈ। ਤੁਸੀਂ Pi ਨੂੰ WSL ਵਿੱਚ ਵੀ ਇੰਸਟਾਲ ਕਰ ਸਕਦੇ ਹੋ, ਜੋ Windows ਦੇ ਅੰਦਰ ਉਪਲਬਧ Linux ਵਾਤਾਵਰਣ ਹੈ।

ਜੇਕਰ ਤੁਸੀਂ npm ਨਾਲ ਇੰਸਟਾਲ ਕਰਨਾ ਚੁਣਦੇ ਹੋ, ਤਾਂ ਤੁਹਾਨੂੰ Node.js 22.19 ਜਾਂ ਬਾਅਦ ਦੇ ਸੰਸਕਰਣ ਦੀ ਲੋੜ ਹੈ। npm Node.js ਦੇ ਨਾਲ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਪੈਕੇਜ ਮੈਨੇਜਰ ਹੈ ਅਤੇ ਕਮਾਂਡ ਲਾਈਨ ਤੋਂ Pi ਨੂੰ ਇੰਸਟਾਲ ਕਰ ਸਕਦਾ ਹੈ।

macOS Linux

install.sh

• ਅਧਿਕਾਰਤ ਸਕ੍ਰਿਪਟ ਨੂੰ curl ਕਰੋ
• ਇੰਸਟਾਲਰ ਨਿਰਭਰਤਾਵਾਂ (dependencies) ਨੂੰ ਪਿੰਨ ਕਰਦਾ ਹੈ
• pi update ਨਾਲ ਅੱਪਡੇਟ ਕਰੋ

Windows

install.ps1

• ਅਧਿਕਾਰਤ PowerShell ਕਮਾਂਡ
• Git for Windows Bash ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ
• ਤੁਸੀਂ WSL ਦੀ ਵਰਤੋਂ ਵੀ ਕਰ ਸਕਦੇ ਹੋ

Node ਪਹਿਲਾਂ ਹੀ ਇੰਸਟਾਲ ਹੈ

npm

• Node 22.19+ ਦੀ ਲੋੜ ਹੈ
• ਪੈਕੇਜ ਦਾ ਨਾਮ pi-coding-agent ਹੈ
• --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 ਸ਼ਾਮਲ ਕਰੋ। 2026-10-09 ਨੂੰ, ਇਸਨੇ 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 ~/.pi/agent/settings.json ਵਿੱਚ shellPath ਸੈਟਿੰਗ, Program Files ਦੇ ਅਧੀਨ Git Bash, ਅਤੇ ਫਿਰ PATH ’ਤੇ bash.exe ਦੀ ਜਾਂਚ ਕਰਦਾ ਹੈ, ਇਸ ਕ੍ਰਮ ਵਿੱਚ। shellPath Bash ਦੇ ਸਥਾਨ ਨੂੰ ਨਿਰਧਾਰਤ ਕਰਦਾ ਹੈ, ਜਦੋਂ ਕਿ PATH ਉਹਨਾਂ ਡਾਇਰੈਕਟਰੀਆਂ ਦੀ ਸੂਚੀ ਹੈ ਜਿੱਥੇ ਸਿਸਟਮ ਕਮਾਂਡਾਂ ਦੀ ਖੋਜ ਕਰਦਾ ਹੈ।

Pi ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਤੁਸੀਂ ਇਸਦੀ ਜਾਂਚ ਕਰਨ ਲਈ !printf 'Bash is working\n' ਦਾਖਲ ਕਰ ਸਕਦੇ ਹੋ। ਜੇਕਰ ਤੁਹਾਡੀਆਂ ਫਾਈਲਾਂ ਅਤੇ ਟੂਲ ਪਹਿਲਾਂ ਹੀ WSL ਵਿੱਚ ਹਨ, ਤਾਂ Quickstart ਦੀ ਪਾਲਣਾ ਕਰਕੇ ਉਸ Linux ਵਾਤਾਵਰਣ ਵਿੱਚ Pi ਇੰਸਟਾਲ ਕਰੋ।

ਅੱਗੇ, ਉਹ ਫੋਲਡਰ ਦਾਖਲ ਕਰੋ ਜਿਸਦਾ Pi ਨਿਰੀਖਣ ਕਰਨਾ ਚਾਹੁੰਦਾ ਹੈ ਜਾਂ ਜਿਸ ’ਤੇ ਕੰਮ ਕਰਨਾ ਚਾਹੁੰਦਾ ਹੈ, ਅਤੇ ਫਿਰ ਇਸਨੂੰ ਸ਼ੁਰੂ ਕਰੋ:

cd /path/to/folder
pi

ਇਹ ਫੋਲਡਰ Pi ਦਾ ਮੌਜੂਦਾ ਕੰਮਕਾਜੀ ਦਾਇਰਾ (scope) ਬਣ ਜਾਂਦਾ ਹੈ। 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 ਐਂਡਪੁਆਇੰਟ ਹੈ ਜਿਸ ’ਤੇ Pi ਬੇਨਤੀਆਂ ਭੇਜਦਾ ਹੈ, ਅਤੇ ਇਸ ਵਿੱਚ /v1 ਸ਼ਾਮਲ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ। apiKey API ਤੱਕ ਪਹੁੰਚ ਕਰਨ ਲਈ ਵਰਤੀ ਜਾਣ ਵਾਲੀ ਕੁੰਜੀ ਹੈ। Model ID ਕਾਲ ਕੀਤੇ ਜਾਣ ਵਾਲੇ ਮਾਡਲ ਦਾ ਨਾਮ ਹੈ ਅਤੇ ਇਸਨੂੰ ਮੌਜੂਦਾ OmniProxy ਮਾਡਲ ਸੂਚੀ ਵਿੱਚੋਂ ਪੂਰਾ ਕਾਪੀ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ।

api ਨੂੰ openai-completions ’ਤੇ ਸੈੱਟ ਕਰੋ, ਜਿਵੇਂ ਕਿ ਅਨੁਕੂਲ API ਉਦਾਹਰਣ ਵਿੱਚ ਦਿਖਾਇਆ ਗਿਆ ਹੈ। ਇਹ ਖੇਤਰ Pi ਨੂੰ ਦੱਸਦਾ ਹੈ ਕਿ ਬੇਨਤੀਆਂ ਭੇਜਣ ਵੇਲੇ ਕਿਹੜੇ API ਫਾਰਮੈਟ ਦੀ ਵਰਤੋਂ ਕਰਨੀ ਹੈ।

ਪੂਰੀ ਮਾਡਲ ID ਕਾਪੀ ਕਰੋ, ਜਿਸ ਵਿੱਚ ਨਾਮ ਵਿੱਚ ਕੋਈ ਵੀ ਸਲੈਸ਼ ਸ਼ਾਮਲ ਹੋਵੇ। 2026-10-09 ਨੂੰ, ਪ੍ਰੋਵਾਈਡਰ ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ ਦੋ ਸੰਦਰਭ IDs 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 ਮੌਜੂਦਾ OmniProxy ਮਾਡਲ ਸੂਚੀ ਵਿੱਚ ਪੂਰੀ ਮਾਡਲ ID ਨਾਲ ਮੇਲ ਖਾਂਦੀ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ। input ਦਰਸਾਉਂਦਾ ਹੈ ਕਿ ਮਾਡਲ ਇੱਥੇ ਟੈਕਸਟ ਇਨਪੁਟ ਲਈ ਕੌਂਫਿਗਰ ਕੀਤਾ ਗਿਆ ਹੈ।

apiKey ਨੂੰ ਇੱਕ ਲਿਟਰਲ ਮੁੱਲ ਵਜੋਂ ਦਾਖਲ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ, ਜਾਂ $NAME ਜਾਂ ${NAME} ਵਜੋਂ ਤਾਂ ਜੋ Pi ਇਸਨੂੰ ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਤੋਂ ਪੜ੍ਹ ਸਕੇ। ! ਨਾਲ ਸ਼ੁਰੂ ਹੋਣ ਵਾਲੇ ਮੁੱਲ ਨੂੰ ਇੱਕ ਕਮਾਂਡ ਵਜੋਂ ਮੰਨਿਆ ਜਾਂਦਾ ਹੈ ਅਤੇ ਹਰ ਬੇਨਤੀ ਲਈ ਐਗਜ਼ੀਕਿਊਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ ਅਸਲ ਕੁੰਜੀ ਕਮਿਟ ਨਾ ਕਰੋ। ਜੇਕਰ ਗੇਟਵੇ ਕੁੰਜੀਆਂ ਨੂੰ ਪ੍ਰਮਾਣਿਤ ਨਹੀਂ ਕਰਦਾ ਹੈ, ਤਾਂ ਤੁਸੀਂ ਸਿਰਫ਼ ਆਪਣੀ ਸਥਾਨਕ ਮਸ਼ੀਨ ’ਤੇ ਵਰਤਿਆ ਜਾਣ ਵਾਲਾ ਇੱਕ ਪਲੇਸਹੋਲਡਰ ਸਟ੍ਰਿੰਗ ਦਾਖਲ ਕਰ ਸਕਦੇ ਹੋ। 2026-10-09 ਨੂੰ, Pi ਨੇ ਇਸ ਕੌਂਫਿਗਰੇਸ਼ਨ ਨਾਲ ਫਾਈਲ ਨੂੰ ਸਫਲਤਾਪੂਰਵਕ ਪੜ੍ਹ ਲਿਆ।

/model ਖੋਲ੍ਹਣ ਨਾਲ ਇਹ ਫਾਈਲ ਰੀਲੋਡ ਹੋ ਜਾਂਦੀ ਹੈ। /model ਮਾਡਲਾਂ ਨੂੰ ਦੇਖਣ ਅਤੇ ਚੁਣਨ ਲਈ Pi ਵਿੱਚ ਇੰਟਰਫੇਸ ਹੈ। ਕਸਟਮ ਮਾਡਲ /model ਵਿੱਚ ਉਦੋਂ ਤੱਕ ਦਿਖਾਈ ਨਹੀਂ ਦਿੰਦੇ ਜਦੋਂ ਤੱਕ Pi ਉਹਨਾਂ ਦੇ ਕ੍ਰੈਡੈਂਸ਼ੀਅਲ ਹੱਲ ਨਹੀਂ ਕਰ ਲੈਂਦਾ। ਇੱਕ ਮਾਡਲ ਚੁਣਨ ਤੋਂ ਬਾਅਦ, ਨਵੇਂ ਸੈਸ਼ਨਾਂ ਲਈ ਇਸਨੂੰ ਡਿਫੌਲਟ ਮਾਡਲ ਵਜੋਂ ਸੁਰੱਖਿਅਤ ਕਰਨ ਲਈ Ctrl+S ਦਬਾਓ।

ਫਾਈਲ

models.json

• ਡਿਫੌਲਟ ਡਾਇਰੈਕਟਰੀ: ~/.pi/agent
• providers ਦੇ ਅਧੀਨ ਇੱਕ ਐਂਟਰੀ ਸ਼ਾਮਲ ਕਰੋ
• api ਨੂੰ completions 'ਤੇ ਸੈੱਟ ਕਰੋ

ਪਤਾ

baseUrl

• /v1 ਸ਼ਾਮਲ ਕਰੋ
• apiKey ਇੱਕ ਵੇਰੀਏਬਲ ਦਾ ਹਵਾਲਾ ਦੇ ਸਕਦਾ ਹੈ
• ਮਾਡਲ id ਸਹੀ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ

ਚੁਣੋ

/model

• ਇਸਨੂੰ ਖੋਲ੍ਹਣ ਨਾਲ ਫਾਈਲ ਰੀਲੋਡ ਹੁੰਦੀ ਹੈ
• ਉਹ ਮਾਡਲ ਚੁਣੋ ਜੋ ਤੁਸੀਂ ਹੁਣੇ ਜੋੜਿਆ ਹੈ
• Ctrl+S ਇਸਨੂੰ ਡਿਫੌਲਟ ਵਜੋਂ ਸੁਰੱਖਿਅਤ ਕਰਦਾ ਹੈ

ਇੱਕ ਅਸਲ ਕੰਮ ਨਾਲ ਤਸਦੀਕ ਕਰੋ

ਕੌਂਫਿਗਰੇਸ਼ਨ ਪੂਰੀ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਤੁਸੀਂ ਫਾਈਲਾਂ ਵਾਲੀ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਇੱਕ ਗੈਰ-ਇੰਟਰਐਕਟਿਵ ਜਾਂਚ ਕਰ ਸਕਦੇ ਹੋ। ਗੈਰ-ਇੰਟਰਐਕਟਿਵ ਮੋਡ ਦਾ ਮਤਲਬ ਹੈ ਕਿ Pi ਇਸ ਇੱਕ ਕੰਮ ਨੂੰ ਪੂਰਾ ਕਰਦਾ ਹੈ ਅਤੇ ਫਿਰ ਚੱਲ ਰਹੀ ਗੱਲਬਾਤ ਵਿੱਚ ਦਾਖਲ ਹੋਣ ਦੀ ਬਜਾਏ ਬਾਹਰ ਨਿਕਲ ਜਾਂਦਾ ਹੈ। --model ਤੋਂ ਬਾਅਦ ਦੇ ਮੁੱਲ ਨੂੰ ਮੌਜੂਦਾ OmniProxy ਸੂਚੀ ਤੋਂ ਪੂਰੀ ID ਨਾਲ ਬਦਲੋ:

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 ਨੂੰ ਫਾਈਲ ਨੂੰ ਸੋਧਣ ਲਈ ਸਪੱਸ਼ਟ ਤੌਰ ’ਤੇ ਨਿਰਦੇਸ਼ ਨਹੀਂ ਦਿੰਦਾ ਹੈ। 2026-10-09 ਨੂੰ, Pi 1.1.0 ਨੇ ਫਾਈਲ ਸਮੱਗਰੀ ਨੂੰ ਸਫਲਤਾਪੂਰਵਕ ਪੜ੍ਹ ਲਿਆ। ਪਹਿਲੀ ਪ੍ਰਤੀਕਿਰਿਆ ਵਿੱਚ ਲਗਭਗ ਦੋ ਮਿੰਟ ਲੱਗੇ।

ਤੁਸੀਂ ਇੰਟਰਐਕਟਿਵ ਮੋਡ ਦੀ ਵਰਤੋਂ ਵੀ ਕਰ ਸਕਦੇ ਹੋ: ਡਾਇਰੈਕਟਰੀ ਦਾਖਲ ਕਰੋ, pi ਚਲਾਓ, ਅਤੇ ਫਿਰ /model ਨਾਲ ਇੱਕ ਮਾਡਲ ਚੁਣੋ। Quickstart ਵਿੱਚ ਇੱਕ ਉਦਾਹਰਣ ਕੰਮ Pi ਨੂੰ ਇਹ ਸਮਝਾਉਣ ਲਈ ਕਹਿੰਦਾ ਹੈ ਕਿ ਰਿਪੋਜ਼ਟਰੀ ਕਿਵੇਂ ਵਿਵਸਥਿਤ ਹੈ ਅਤੇ ਇਸਦੇ ਚੈੱਕ ਕਿਵੇਂ ਚਲਾਉਣੇ ਹਨ। ਦੇਖੋ ਕਿ ਕੀ ਇਹ ਫਾਈਲਾਂ ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ ਵਿਆਖਿਆ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ, ਫਿਰ OmniProxy ਦੇ ਬੇਨਤੀ ਲੌਗਸ ਵਿੱਚ ਸਰੋਤ ਅਤੇ ਮਾਡਲ ID ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ।

ਲਾਂਚ ਕਰੋ

pi ਲਾਂਚ ਹੁੰਦਾ ਹੈ

• ਪਹਿਲਾਂ ਫੋਲਡਰ 'ਤੇ cd ਕਰੋ
• pi --version ਆਉਟਪੁੱਟ ਪੈਦਾ ਕਰਦਾ ਹੈ
• ਮਾਡਲ ਦਾ ਨਾਮ ਇੰਟਰਫੇਸ ਦੇ ਹੇਠਾਂ ਦਿਖਾਈ ਦਿੰਦਾ ਹੈ

ਕੰਮ

ਇਸਨੇ ਡਾਇਰੈਕਟਰੀ ਪੜ੍ਹ ਲਈ

• ਪੁੱਛੋ ਕਿ ਰਿਪੋਜ਼ਟਰੀ ਕਿਵੇਂ ਵਿਵਸਥਿਤ ਹੈ
• ਉਹਨਾਂ ਫਾਈਲਾਂ ਦੀ ਸਮੀਖਿਆ ਕਰੋ ਜੋ ਇਹ ਸੂਚੀਬੱਧ ਕਰਦਾ ਹੈ
• ਸਿਰਫ਼ ਇੱਕ ਸਫਲ ਕੌਂਫਿਗਰੇਸ਼ਨ ਸੇਵ 'ਤੇ ਨਿਰਭਰ ਨਾ ਰਹੋ

ਲੌਗਸ

ਗੇਟਵੇ ਵਿੱਚ ਦਿਖਾਈ ਦਿੰਦਾ ਹੈ

• ਸਰੋਤ Pi ਹੈ
• ਮਾਡਲ ID ਮੇਲ ਖਾਂਦਾ ਹੈ
• ਕੁੰਜੀ ਨੂੰ ਸਥਾਨਕ ਮਸ਼ੀਨ 'ਤੇ ਰੱਖੋ

ਆਮ ਗਲਤੀਆਂ

• pi ਨਹੀਂ ਲੱਭਿਆ ਜਾ ਸਕਦਾ: ਟਰਮੀਨਲ ਨੂੰ ਦੁਬਾਰਾ ਖੋਲ੍ਹੋ ਅਤੇ pi --version ਨੂੰ ਦੁਬਾਰਾ ਅਜ਼ਮਾਓ। npm ਇੰਸਟਾਲੇਸ਼ਨ ਲਈ, ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਗਲੋਬਲ ਬਿਨ ਡਾਇਰੈਕਟਰੀ PATH ’ਤੇ ਹੈ।
• ਕਸਟਮ ਮਾਡਲ /model ਵਿੱਚ ਦਿਖਾਈ ਨਹੀਂ ਦਿੰਦੇ: ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ models.json, ~/.pi/agent/ ਵਿੱਚ ਹੈ, ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ apiKey ਨੂੰ ਹੱਲ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ, ਅਤੇ ਫਿਰ /model ਨੂੰ ਦੁਬਾਰਾ ਖੋਲ੍ਹੋ।
• Windows ਰਿਪੋਰਟ ਕਰਦਾ ਹੈ ਕਿ Bash ਨਹੀਂ ਲੱਭਿਆ ਜਾ ਸਕਦਾ: Git for Windows ਇੰਸਟਾਲ ਕਰੋ, ਜਾਂ ~/.pi/agent/settings.json ਵਿੱਚ shellPath ਸੈੱਟ ਕਰੋ। JSON ਵਿੱਚ ਬੈਕਸਲੈਸ਼ ਦੋ ਵਾਰ ਲਿਖੇ ਜਾਣੇ ਚਾਹੀਦੇ ਹਨ।
• ਬੇਨਤੀ ਰੱਦ ਕਰ ਦਿੱਤੀ ਗਈ ਹੈ: ਜਾਂਚ ਕਰੋ ਕਿ api, openai-completions ਹੈ ਅਤੇ baseUrl, /v1 ’ਤੇ ਖਤਮ ਹੁੰਦਾ ਹੈ। ਸਿਰਫ਼ ਇਸ ਲਈ ਵਾਧੂ ਅਨੁਕੂਲਤਾ ਵਿਕਲਪਾਂ ਨੂੰ ਸਮਰੱਥ ਨਾ ਕਰੋ ਕਿਉਂਕਿ ਸੇਵਾ ਆਪਣੇ ਆਪ ਨੂੰ ਅਨੁਕੂਲ ਦੱਸਦੀ ਹੈ।
• ਮਾਡਲ ID ਅਵੈਧ ਹੈ: ਇਸਨੂੰ ਮੌਜੂਦਾ OmniProxy ਸੂਚੀ ਤੋਂ ਦੁਬਾਰਾ ਕਾਪੀ ਕਰੋ।

ਅਧਿਕਾਰਤ ਹਵਾਲੇ

ਇੰਸਟਾਲੇਸ਼ਨ ਕਮਾਂਡਾਂ ਲਈ, Pi ਵੈੱਬਸਾਈਟ ਅਤੇ Quickstart ਦੇਖੋ। ਮਾਡਲ ਫਾਈਲ ਲਈ, ਇੱਕ ਮਾਡਲ ਚੁਣੋ ਅਤੇ ਕੌਂਫਿਗਰੇਸ਼ਨ ਦੇਖੋ। Windows ਕਮਾਂਡ ਵਾਤਾਵਰਣ ਲਈ, Windows ’ਤੇ Pi ਚਲਾਓ ਦੇਖੋ। ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਵਰਤੀਆਂ ਗਈਆਂ ਮਾਡਲ IDs ਲਈ, Gemini ਮਾਡਲ ਸੂਚੀ ਅਤੇ xAI ਮਾਡਲ ਪੰਨਾ ਦੇਖੋ।

ਆਪਣੇ ਖੁਦ ਦੇ OmniProxy ਕਨਫਿਗਰੇਸ਼ਨ ਤੋਂ ਮੁੱਲਾਂ ਨਾਲ ਹਰੇਕ ਪਲੇਸਹੋਲਡਰ ਨੂੰ ਬਦਲੋ। ਕਦੇ ਵੀ ਅਸਲ ਕੀ ਪ੍ਰਕਾਸ਼ਿਤ ਨਾ ਕਰੋ।

ਸੰਭਾਲਿਆ ਗਿਆ ਨਤੀਜਾ ਜਾਂ HTTP 200 ਸਿਰਫ਼ ਪੂਰੀ ਏਜੰਟ ਅਨੁਕੂਲਤਾ ਨੂੰ ਸਾਬਤ ਨਹੀਂ ਕਰਦਾ। OmniProxy ਦੇ ਬੇਨਤੀ ਰਿਕਾਰਡ ਵਿੱਚ ਸਰੋਤ ਅਤੇ ਮਾਡਲ ਦੀ ਜਾਂਚ ਕਰੋ।

ਅਧਿਕਾਰਤ ਸਰੋਤ · Pi ↗