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

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

சப்-ஏஜென்ட்டுகள் ஒரு பணியின் ஒரு பகுதியை மற்றொரு உதவியாளருக்கு வழங்குகின்றன, அதே சமயம் பிளான் மோட் (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 செய்யவும்
• இன்ஸ்டாலர் டிபென்டென்சிகளைப் பின் (pin) செய்கிறது
• 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-ன் தற்போதைய வேலை வரம்பாக (working 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 என்பது 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-ஐ அழுத்தவும்.

கோப்பு

models.json

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

முகவரி

baseUrl

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

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

/model

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

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

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

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

தொடங்குதல்

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

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

பணி

இது டைரக்டரியை வாசித்தது

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

பதிவுகள்

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 ↗