Pi-ஐ நிறுவுதல் மற்றும் OmniProxy-ஐ உள்ளமைத்தல்

Pi என்பது ஒரு சிறிய டெர்மினல் உதவியாளர்—கட்டளை வரியில் உங்களுடன் நேரடியாகப் பேசும், கோப்புகளை வாசிக்கும் மற்றும் பணிகளை முடிக்கும் ஒரு நிரல். இது ஒரு குறுகிய கணினி தூண்டுதலைக் (system prompt) கொண்டுள்ளது மற்றும் இயல்பாகவே சில கருவிகளை மட்டுமே கொண்டுள்ளது. உங்களுக்கு பிற கட்டளைகள், பணிப்பாய்வுகள் அல்லது இடைமுகங்கள் தேவைப்பட்டால், அவற்றை நீட்டிப்புகள் (extensions) மூலம் பின்னர் சேர்க்கலாம். நீட்டிப்புகள் Pi-க்கு திறன்களைச் சேர்க்கும் கூறுகளாகும், மேலும் அவற்றை உருவாக்கிய பிறகு மற்றவர்களுடன் பகிர்ந்து கொள்ளலாம்.

துணை-ஏஜெண்டுகள் (Subagents) ஒரு பணியின் ஒரு பகுதியை மற்றொரு உதவியாளருக்கு வழங்குகின்றன, அதே சமயம் திட்ட முறை (plan mode) செயல்படுத்தத் தொடங்குவதற்கு முன் படிகளை ஒழுங்கமைக்கிறது. எந்த அம்சமும் இயல்பாக சேர்க்கப்படவில்லை, ஆனால் அவற்றை உருவாக்க Pi-ஐக் கேட்கலாம் அல்லது மற்றவர்கள் பகிர்ந்த தொகுப்புகளை நிறுவலாம்.

தொடங்குவதற்கு முன்

macOS மற்றும் Linux ஒரு நிறுவல் ஸ்கிரிப்டைப் பயன்படுத்துகின்றன—இது Pi-ஐத் தானாகவே பதிவிறக்கி நிறுவும் ஒரு கட்டளையாகும். Windows-ல், Pi முகப்புப் பக்கத்தில் வழங்கப்பட்ட PowerShell கட்டளையைப் பயன்படுத்தவும். PowerShell என்பது Windows-உடன் சேர்க்கப்பட்ட கட்டளை-வரி சூழலாகும். Windows-க்குள் கிடைக்கும் Linux சூழலான WSL-லும் நீங்கள் Pi-ஐ நிறுவலாம்.

நீங்கள் 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 update மூலம் Pi-ஐப் புதுப்பிக்கவும். 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-ன் தற்போதைய வேலை வரம்பாக மாறுகிறது. 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 என்பது Pi கோரிக்கைகளை அனுப்பும் API இறுதிப்புள்ளியாகும், இது /v1-ஐ உள்ளடக்கியிருக்க வேண்டும். apiKey என்பது API-ஐ அணுகப் பயன்படுத்தப்படும் விசையாகும். Model ID என்பது அழைக்கப்பட வேண்டிய மாடலின் பெயராகும் மற்றும் தற்போதைய OmniProxy மாடல் பட்டியலிலிருந்து முழுமையாக நகலெடுக்கப்பட வேண்டும்.

இணக்கமான API எடுத்துக்காட்டில் காட்டப்பட்டுள்ளபடி, api-ஐ openai-completions-க்கு அமைக்கவும். இந்த புலம் கோரிக்கைகளை அனுப்பும்போது எந்த API வடிவத்தைப் பயன்படுத்த வேண்டும் என்று Pi-க்குத் தெரிவிக்கிறது.

பெயரில் உள்ள ஸ்லாஷ்கள் உட்பட முழு மாடல் ஐடியையும் நகலெடுக்கவும். 2026-10-09 அன்று, வழங்குநர் ஆவணங்களில் இருந்த இரண்டு குறிப்பு ஐடிகள் 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 மாடல் பட்டியலில் உள்ள முழுமையான மாடல் ஐடியுடன் பொருந்த வேண்டும். input என்பது மாடல் இங்கே உரை உள்ளீட்டிற்காக உள்ளமைக்கப்பட்டுள்ளது என்பதைக் குறிக்கிறது.

apiKey-ஐ ஒரு நேரடி மதிப்பாக உள்ளிடலாம், அல்லது $NAME அல்லது ${NAME} ஆக உள்ளிடலாம், இதனால் Pi அதை ஒரு சூழல் மாறியிலிருந்து வாசிக்கும். !-ல் தொடங்கும் மதிப்பு ஒரு கட்டளையாகக் கருதப்பட்டு ஒவ்வொரு கோரிக்கைக்கும் இயக்கப்படுகிறது. உண்மையான விசையை களஞ்சியத்தில் சமர்ப்பிக்க வேண்டாம். Gateway விசைகளைச் சரிபார்க்கவில்லை என்றால், உங்கள் உள்ளூர் கணினியில் மட்டுமே பயன்படுத்தப்படும் பிளேஸ்ஹோல்டர் சரத்தை நீங்கள் உள்ளிடலாம். 2026-10-09 அன்று, Pi இந்த உள்ளமைவுடன் கோப்பை வெற்றிகரமாக வாசித்தது.

/model-ஐத் திறப்பது இந்த கோப்பை மீண்டும் ஏற்றுகிறது (reloads). /model என்பது மாடல்களைப் பார்ப்பதற்கும் தேர்ந்தெடுப்பதற்கும் Pi-ல் உள்ள இடைமுகமாகும். Pi அவற்றின் சான்றுகளைத் தீர்க்கும் வரை தனிப்பயன் மாடல்கள் /model-ல் தோன்றாது. ஒரு மாடலைத் தேர்ந்தெடுத்த பிறகு, புதிய அமர்வுகளுக்கான இயல்புநிலை மாடலாக அதைச் சேமிக்க Ctrl+S-ஐ அழுத்தவும்.

கோப்பு (File)

models.json

• இயல்புநிலை கோப்பகம்: ~/.pi/agent
• providers-ன் கீழ் ஒரு உள்ளீட்டைச் சேர்க்கவும்
• api-ஐ completions-க்கு அமைக்கவும்

முகவரி (Address)

baseUrl

• /v1-ஐச் சேர்க்கவும்
• apiKey ஒரு மாறியைக் குறிக்கலாம்
• மாடல் ஐடி துல்லியமாக இருக்க வேண்டும்

தேர்ந்தெடுக்கவும்

/model

• அதைத் திறப்பது கோப்பை மீண்டும் ஏற்றுகிறது
• நீங்கள் இப்போது சேர்த்த மாடலைத் தேர்ந்தெடுக்கவும்
• Ctrl+S அதை இயல்புநிலையாகச் சேமிக்கிறது

உண்மையான பணியுடன் சரிபார்க்கவும்

உள்ளமைவை முடித்த பிறகு, கோப்புகளைக் கொண்ட கோப்பகத்தில் நீங்கள் ஊடாடாத (non-interactive) சரிபார்ப்பைச் செய்யலாம். ஊடாடாத முறை என்பது Pi இந்த ஒரு பணியை முடித்துவிட்டு வெளியேறும், தொடர்ந்து நடக்கும் உரையாடலில் நுழையாது என்று அர்த்தம். --model-க்கு பின் உள்ள மதிப்பை தற்போதைய 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-ஐ கோப்பை மாற்ற வேண்டாம் என்றும் வெளிப்படையாக அறிவுறுத்துகிறது. 2026-10-09 அன்று, Pi 1.1.0 கோப்பு உள்ளடக்கங்களை வெற்றிகரமாக வாசித்தது. முதல் பதிலுக்கு சுமார் இரண்டு நிமிடங்கள் ஆனது.

நீங்கள் ஊடாடும் முறையையும் பயன்படுத்தலாம்: கோப்பகத்தை உள்ளிட்டு, pi-ஐ இயக்கி, பின்னர் /model மூலம் ஒரு மாடலைத் தேர்ந்தெடுக்கவும். Quickstart-ல் உள்ள ஒரு எடுத்துக்காட்டு பணி, களஞ்சியம் எவ்வாறு ஒழுங்கமைக்கப்பட்டுள்ளது மற்றும் அதன் சோதனைகளை எவ்வாறு இயக்குவது என்பதை விளக்குமாறு Pi-ஐக் கேட்கிறது. அது கோப்புகளை வாசித்து விளக்கம் அளிக்கிறதா என்று கவனிக்கவும், பின்னர் OmniProxy-ன் கோரிக்கை பதிவுகளில் ஆதாரம் மற்றும் மாடல் ஐடியை உறுதிப்படுத்தவும்.

தொடங்குதல் (Launch)

pi தொடங்குகிறது

• முதலில் கோப்புறைக்கு cd செய்யவும்
• pi --version வெளியீட்டைத் தருகிறது
• மாடல் பெயர் இடைமுகத்தின் கீழே தோன்றுகிறது

பணி

இது கோப்பகத்தை வாசித்தது

• களஞ்சியம் எவ்வாறு ஒழுங்கமைக்கப்பட்டுள்ளது என்று கேட்கவும்
• அது பட்டியலிடும் கோப்புகளை மதிப்பாய்வு செய்யவும்
• வெற்றிகரமான உள்ளமைவு சேமிப்பை மட்டும் நம்ப வேண்டாம்

பதிவுகள் (Logs)

Gateway-ல் தெரியும்

• ஆதாரம் Pi
• மாடல் ஐடி பொருந்துகிறது
• விசையை உள்ளூர் கணினியில் வைத்திருங்கள்

பொதுவான பிழைகள்

• pi-ஐக் கண்டறிய முடியவில்லை: டெர்மினலை மீண்டும் திறந்து pi --version-ஐ மீண்டும் முயற்சிக்கவும். npm நிறுவலுக்கு, குளோபல் பின் கோப்பகம் PATH-ல் இருப்பதை உறுதிப்படுத்தவும்.
• தனிப்பயன் மாடல்கள் /model-ல் தோன்றவில்லை: models.json என்பது ~/.pi/agent/-ல் இருப்பதை உறுதிப்படுத்தவும், apiKey தீர்க்கப்பட முடியும் என்பதைச் சரிபார்க்கவும், பின்னர் /model-ஐ மீண்டும் திறக்கவும்.
• Windows Bash-ஐக் கண்டறிய முடியவில்லை என்று தெரிவிக்கிறது: Git for Windows-ஐ நிறுவவும் அல்லது ~/.pi/agent/settings.json-ல் shellPath-ஐ அமைக்கவும். JSON-ல் உள்ள பேக்ஸ்லாஷ்கள் (backslashes) இரண்டு முறை எழுதப்பட வேண்டும்.
• கோரிக்கை நிராகரிக்கப்பட்டது: api என்பது openai-completions என்பதையும், baseUrl என்பது /v1-ல் முடிவடைவதையும் சரிபார்க்கவும். சேவை தன்னை இணக்கமானது என்று விவரிப்பதால் மட்டும் கூடுதல் இணக்கத்தன்மை விருப்பங்களைச் செயல்படுத்த வேண்டாம்.
• மாடல் ஐடி செல்லாது: தற்போதைய OmniProxy பட்டியலிலிருந்து அதை மீண்டும் நகலெடுக்கவும்.

அதிகாரப்பூர்வ குறிப்புகள்

நிறுவல் கட்டளைகளுக்கு, Pi website மற்றும் Quickstart-ஐப் பார்க்கவும். மாடல் கோப்பிற்கு, Choose a Model மற்றும் Configuration-ஐப் பார்க்கவும். Windows கட்டளை சூழலுக்கு, Run Pi on Windows-ஐப் பார்க்கவும். எடுத்துக்காட்டுகளில் பயன்படுத்தப்படும் மாடல் ஐடிகளுக்கு, Gemini model list மற்றும் xAI models page-ஐப் பார்க்கவும்.

உங்கள் சொந்த OmniProxy அமைப்பிலிருந்து மதிப்புகளுடன் ஒவ்வொரு இடம்பெயர்வையும் மாற்றவும். ஒரு உண்மையான திறவுகோலை வெளியிட வேண்டாம்.

ஒரு சேமிக்கப்பட்ட முடிவு அல்லது HTTP 200 மட்டுமே முழு ஏஜெண்ட் பொருத்தத்தை நிரூபிப்பதில்லை. OmniProxy-ன் கோரிக்கைப் பதிவில் மூலம் மற்றும் மாடலைச் சரிபார்க்கவும்.

அதிகாரப்பூர்வ மூலங்கள் · Pi ↗