goose-ஐ நிறுவுதல் மற்றும் தனிப்பயன் வழங்குநரை (Custom Provider) உள்ளமைத்தல்

goose என்பது உங்கள் கணினியில் இயங்கும் ஒரு பொது-நோக்க AI உதவியாளராகும். குறியீட்டு முறைக்கு கூடுதலாக, இது ஆராய்ச்சி, எழுதுதல், ஆட்டோமேஷன் மற்றும் தரவு அமைப்பைக் கையாள முடியும். நீங்கள் அதை டெஸ்க்டாப் ஆப், முனையம் அல்லது API மூலம் பயன்படுத்தலாம், மேலும் டெஸ்க்டாப் மற்றும் முனையப் பதிப்புகள் ஒரே மாதிரி கட்டமைப்பைப் பகிர்ந்து கொள்கின்றன. இது மீண்டும் மீண்டும் வரும் குறியீட்டுப் பணிகளுக்கு ஏற்றது மற்றும் GitHub, தரவுத்தளங்கள் மற்றும் கோப்புகளுடனும் இணைக்க முடியும்.

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

goose இரண்டு நிறுவல் விருப்பங்களை வழங்குகிறது: டெஸ்க்டாப் மற்றும் CLI. டெஸ்க்டாப் என்பது சாளரத்தைக் கொண்ட வரைகலை பதிப்பாகும், அதே சமயம் CLI முனையத்தில் கட்டளைகளை உள்ளிடுவதன் மூலம் பயன்படுத்தப்படுகிறது. இரண்டும் வழங்குநர் (Provider) மற்றும் மாதிரி உட்பட ஒரே முக்கிய கட்டமைப்பைப் பகிர்ந்து கொள்கின்றன. வழங்குநர் என்பது எந்த மாதிரி சேவையைப் பயன்படுத்த வேண்டும் என்று goose-க்குக் கூறும் இணைப்பு கட்டமைப்பாகும்.

சாளரம் வேண்டுமா

goose Desktop

• macOS-இல் zip-ஐப் பதிவிறக்கவும்
• அல்லது brew cask-ஐப் பயன்படுத்தவும்
• Linux-இல் நிறுவி தொகுப்பைப் பயன்படுத்தவும்

முனையம் மட்டும்

goose CLI

• download_cli.sh
• அல்லது Homebrew CLI
• பிறகு goose session-ஐ இயக்கவும்

Windows

முதலில் ஒரு சூழலைத் தேர்ந்தெடுக்கவும்

• Git Bash அல்லது MSYS2
• நீங்கள் PowerShell-ஐயும் பயன்படுத்தலாம்
• கட்டளை கண்டறியப்படவில்லை என்றால், அதை PATH-இல் சேர்க்கவும்

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

முதல் முறையாக நிறுவுதல் மற்றும் தொடங்குதல்

உங்களுக்கு வரைகலை சாளரம் வேண்டுமென்றால்

macOS-க்கு இரண்டு ஆவணப்படுத்தப்பட்ட நிறுவல் முறைகள் உள்ளன:

• நிறுவல் பக்கத்திலிருந்து அதைப் பதிவிறக்கவும். இந்தப் பக்கம் macOS சிலிக்கான் மற்றும் macOS இன்டெல் பதிப்புகளை வழங்குகிறது. பதிவிறக்கிய பிறகு, zip கோப்பை பிரித்தெடுத்து உள்ளே இருக்கும் பயன்பாட்டை இயக்கவும்.
• மாற்றாக, Homebrew-ஐப் பயன்படுத்தவும்:

brew install --cask block-goose

இது அதே பயன்பாட்டைப் பதிவிறக்குகிறது மற்றும் புதுப்பிப்புகளையும் கையாள முடியும்.

நீங்கள் Apple Mac M3-ஐப் பயன்படுத்துகிறீர்கள் மற்றும் பயன்பாட்டைத் திறந்த பிறகு சாளரம் எதுவும் தோன்றவில்லை என்றால், ~/.config வாசிக்கக்கூடியதா மற்றும் எழுதக்கூடியதா என்பதைச் சரிபார்க்கவும். goose பதிவுகளை எழுத இந்த கோப்பகத்தைப் பயன்படுத்துகிறது.

Linux டெஸ்க்டாப் பதிப்பிற்கு, நிறுவல் பக்கத்திலிருந்து அதைப் பதிவிறக்கவும். கிடைக்கக்கூடிய தொகுப்புகள் Ubuntu/Debian-க்கான DEB, RHEL/Fedora-க்கான RPM மற்றும் Flatpak ஆகும். Debian அல்லது Ubuntu-இல், DEB கோப்பைப் பதிவிறக்கி, அது சேமிக்கப்பட்ட கோப்பகத்தைத் திறந்து, sudo dpkg -i (filename).deb-ஐ இயக்கி, பிறகு பயன்பாட்டு மெனுவிலிருந்து goose-ஐத் திறக்கவும். (filename)-ஐ உண்மையான கோப்பு பெயருடன் மாற்றவும்.

Windows டெஸ்க்டாப் பதிப்பிற்கு, நிறுவல் பக்கத்திலிருந்து அதைப் பதிவிறக்கி, zip கோப்பை பிரித்தெடுத்து உள்ளே இருக்கும் பயன்பாட்டை இயக்கவும்.

உங்களுக்கு முனையப் பதிப்பு மட்டும் வேண்டுமென்றால்

macOS மற்றும் Linux-இல், இதை இயக்கவும்:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

நிறுவலின் போது ஊடாடும் கட்டமைப்பைத் தவிர்க்க, bash-க்கு முன்னால் CONFIGURE=false-ஐச் சேர்க்கவும்:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

macOS-இல், நீங்கள் இதையும் இயக்கலாம்:

brew install block-goose-cli

நிறுவப்பட்ட CLI-ஐப் புதுப்பிக்க, இதை இயக்கவும்:

goose update

Windows-இல், பின்வரும் மூன்று சூழல்களில் ஒன்று தேவை: Git Bash (இது Git for Windows-உடன் சேர்க்கப்பட்டுள்ளது மற்றும் பரிந்துரைக்கப்படுகிறது), MSYS2, அல்லது Windows 10/11-உடன் சேர்க்கப்பட்டுள்ள PowerShell. Git Bash மற்றும் MSYS2-இல், மேலே காட்டப்பட்டுள்ள அதே download_cli.sh கட்டளையைப் பயன்படுத்தவும். PowerShell-இல், முதலில் ஸ்கிரிப்டைப் பதிவிறக்கி, பிறகு அதை இயக்கவும்:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

goose PATH-இல் இல்லை என்று உங்களுக்குத் தெரிவிக்கப்பட்டால், நிறுவல் பக்கத்தைப் பின்பற்றி தற்போதைய ஷெல் கட்டமைப்பில் ~/.local/bin அல்லது %USERPROFILE%\.local\bin-ஐச் சேர்த்து, பிறகு முனையத்தை மீண்டும் திறக்கவும். PATH என்பது நிரல்களைத் தேடும் கோப்பகங்களின் தொகுப்பாகும். நிறுவல் கோப்பகம் சேர்க்கப்படவில்லை என்றால், நீங்கள் ஒரு நிரலின் பெயரை நேரடியாக உள்ளிடுவதன் மூலம் அதை இயக்க முடியாமல் போகலாம்.

2026-10-09 நிலவரப்படி, CLI பதிப்பு 1.54.0 ஆகும். முன்னிருப்பாக, நிறுவல் ஸ்கிரிப்ட் நிரலை ~/.local/bin-இல் வைக்கிறது. நீங்கள் GOOSE_BIN_DIR சூழல் மாறி மூலம் இந்த கோப்பகத்தை மாற்றலாம். நீங்கள் அதை மாற்றினால், ஸ்கிரிப்ட் தானாகவே ஷெல் கட்டமைப்பைப் புதுப்பிக்காது, மேலும் முனையம் அந்த கோப்பகம் PATH-இல் இல்லை என்று தெரிவிக்கும். அந்த கோப்பகத்தை PATH-இல் சேர்க்கவும் அல்லது goose-ஐ அதன் முழு பாதையைப் பயன்படுத்தி இயக்கவும்.

நீங்கள் முதல் முறையாக goose-ஐப் பயன்படுத்தும் போது, அது ஒரு வழங்குநரை உள்ளமைக்கக் கேட்கும். நீங்கள் உள்ளமைக்கப்பட்ட வழங்குநர்களைத் தவிர்த்து, அடுத்த பகுதியில் விவரிக்கப்பட்டுள்ளபடி ஒரு தனிப்பயன் வழங்குநரைச் சேர்க்கலாம். முனையத்தில், நீங்கள் வேலை செய்ய விரும்பும் கோப்பகத்திற்குச் சென்று இதை இயக்கவும்:

goose session

OmniProxy-யிலிருந்து இணைப்பு மதிப்புகளைப் பெறுதல்

உங்கள் சொந்த OmniProxy நிகழ்விலிருந்து முகவரி, திறவுகோல் மற்றும் மாதிரி பெயரைத் தயார் செய்யவும். தனிப்பயன் வழங்குநர் உதாரணம் /v1/chat/completions-இல் முடிவடையும் base_url-ஐப் பயன்படுத்துகிறது, எனவே இந்த வழிகாட்டி அதே வடிவத்தைப் பின்பற்றுகிறது:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Copy from the current OmniProxy model list; separate multiple models with commas

தற்போதைய OmniProxy பட்டியலிலிருந்து முழு மாதிரி பெயரையும் நகலெடுக்கவும், சாய்வுக்கோடுகளையும் சேர்க்கவும். 2026-10-09 நிலவரப்படி, வழங்குநர் ஆவணத்தில் உள்ள இரண்டு குறிப்பு அடையாளங்கள் Grok-க்கு grok-4.7 மற்றும் OpenAI ஆவணத்திலிருந்து gpt-6-luna ஆகும். gpt-6-luna Chat Completions-ஐ ஆதரிக்கிறது; Chat Completions-இல் செயல்பாட்டு அழைப்பு (function calling) reasoning_effort என்பது none என அமைக்கப்பட்டால் மட்டுமே ஆதரிக்கப்படும். பட்டியலில் தோன்றாத பெயரை நகலெடுக்க வேண்டாம்.

கருவி கட்டமைப்பை உள்ளிடுதல்

ஒரு தனிப்பயன் வழங்குநர் OpenAI, Anthropic அல்லது Ollama-இணக்கமான வடிவத்தைப் பயன்படுத்தலாம். இணக்கமான வடிவம் என்பது கருவி ஒரு பொதுவான API விவரக்குறிப்பின்படி கோரிக்கைகளை அனுப்புகிறது என்று அர்த்தம். OmniProxy-உடன் இணைக்கும் போது, OpenAI Compatible என்பதைத் தேர்ந்தெடுக்கவும்.

டெஸ்க்டாப்

1. பக்கவாட்டுப் பட்டியைத் திறக்க மேல்-இடது மூலையில் உள்ள பொத்தானைக் கிளிக் செய்யவும்.
2. Settings என்பதைக் கிளிக் செய்யவும்.
3. Models என்பதைக் கிளிக் செய்யவும்.
4. Configure providers என்பதைக் கிளிக் செய்யவும்.
5. சாளரத்தின் கீழே உள்ள Add Custom Provider என்பதைக் கிளிக் செய்யவும்.
6. Provider Type-க்கு, OpenAI Compatible என்பதைத் தேர்ந்தெடுக்கவும். நீங்கள் Display Name-ஐ OmniProxy என அமைக்கலாம். API URL-இல் முந்தைய பகுதியிலிருந்து முகவரியை உள்ளிடவும். திறவுகோல் தேவைப்பட்டால், API Key தேவைப்படும் விருப்பத்தைத் தேர்ந்தெடுத்து உங்கள் OmniProxy திறவுகோலை உள்ளிடவும். Available Models-இல், மாதிரி பெயர்களை உள்ளிட்டு, பல பெயர்களை கமா மூலம் பிரிக்கவும்.
7. Create Provider என்பதைக் கிளிக் செய்யவும்.

டெஸ்க்டாப் பதிப்பு தற்போது இந்த சாளரத்தில் தனிப்பயன் கோரிக்கை தலைப்புகளை (request headers) வரையறுக்க முடியாது. உங்களுக்கு கோரிக்கை தலைப்புகள் தேவைப்பட்டால், வழங்குநரை உருவாக்கிய பிறகு கட்டமைப்பு கோப்பைத் திருத்தவும்.

முனையம்

இதை இயக்கவும்:

goose configure

Custom Providers-ஐத் தேர்ந்தெடுத்து, பிறகு Add A Custom Provider-ஐத் தேர்ந்தெடுக்கவும். API Type-க்கு, OpenAI Compatible என்பதைத் தேர்ந்தெடுத்து, பெயர், API URL, திறவுகோல் தேவையா, மாதிரி பெயர்கள் மற்றும் ஸ்ட்ரீமிங் பதில்கள் ஆதரிக்கப்படுகிறதா என்பதை உள்ளிட அறிவுறுத்தல்களைப் பின்பற்றவும்.

Windows-இல் கைமுறையாக உள்ளமைக்கும் போது, கீசெயின் (keychain) பிழையைப் புகாரளித்தால், திறவுகோலை கீரிங்கில் சேமிப்பதைத் தவிர்த்து, அதற்குப் பதிலாக சூழல் மாறியைப் பயன்படுத்தவும் என்று நிறுவல் வழிமுறைகள் கூறுகின்றன. பிறகு goose configure-ஐ மீண்டும் இயக்கவும். கீசெயின் என்பது ரகசியங்களைச் சேமிக்க இயக்க முறைமையால் பயன்படுத்தப்படும் ஒரு சிறிய பாதுகாப்பான சேமிப்பு அமைப்பாகும்.

கட்டமைப்பு கோப்பு

ஆவணப்படுத்தப்பட்ட கோப்பகங்கள்:

• macOS மற்றும் Linux: ~/.config/goose/custom_providers/
• Windows: %APPDATA%\Block\goose\config\custom_providers\

வழங்கப்பட்ட உதாரணத்தின் அடிப்படையில் நீங்கள் கோப்பை உருவாக்கலாம். பெயர், முகவரி மற்றும் மாதிரிகளை உங்கள் சொந்த மதிப்புகளுடன் மாற்றவும். திறவுகோலை api_key_env-ஆல் குறிப்பிடப்பட்ட சூழல் மாறியில் சேமிக்கவும்; உண்மையான திறவுகோலை கோப்பில் எழுத வேண்டாம்:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

உதாரணத்தில் காட்டப்பட்டுள்ளபடி context_limit-க்கு ஒரு எண் மதிப்பை வைத்திருக்கவும். உண்மையான சூழல் வரம்பு மாதிரி மற்றும் OmniProxy-ஐப் பொறுத்தது; உதாரண எண்ணை மாதிரியின் அதிகாரப்பூர்வ வரம்பாகக் கருத வேண்டாம். அதைப் பயன்படுத்துவதற்கு முன், இதை இயக்கவும்:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

வேலை செய்யும் கோப்பகத்திற்குள் நுழைந்த பிறகு, இதை இயக்கவும்:

goose session --provider omniproxy --model grok-4.7

--model-இன் மதிப்பை பட்டியலிலிருந்து முழு அடையாளத்துடன் மாற்றவும். goose session-க்கு start துணைக்கட்டளை இல்லை. நீங்கள் GOOSE_PROVIDER மற்றும் GOOSE_MODEL சூழல் மாறிகள் மூலம் --provider மற்றும் --model-ஐயும் அமைக்கலாம். கேட்வே திறவுகோல்களைச் சரிபார்க்கவில்லை என்றாலும், OMNIPROXY_API_KEY-க்கு இன்னும் ஒரு மதிப்பு இருக்க வேண்டும். இது உங்கள் உள்ளூர் கணினியில் மட்டும் பயன்படுத்தப்படும் ஒரு பிளேஸ்ஹோல்டர் சரமாக இருக்கலாம். இந்த கட்டமைப்பு 2026-10-09 அன்று சோதனையில் ஒரு கோப்பை வெற்றிகரமாக வாசித்தது.

சாளரம்

Settings

• பக்கவாட்டுப் பட்டியில் Settings
• Models பக்கம்
• Add Custom Provider

முனையம்

goose configure

• Custom Providers-ஐத் தேர்ந்தெடுக்கவும்
• பிறகு சேர் என்பதைத் தேர்ந்தெடுக்கவும்
• வகைக்கு OpenAI Compatible-ஐத் தேர்ந்தெடுக்கவும்

கோப்பு

custom_providers

• macOS மற்றும் Linux-இல், இது ~/.config-இன் கீழ் உள்ளது
• Windows-இல், இது APPDATA-இன் கீழ் உள்ளது
• அதிகாரப்பூர்வ உதாரணத்தின்படி base_url-ஐ அமைக்கவும்

உண்மையான பணியுடன் சரிபார்த்தல்

ஒரு சாதாரண கோப்பைக் கொண்ட கோப்பகத்தைத் திறந்து, முந்தைய பகுதியில் காட்டப்பட்டுள்ளபடி goose session-ஐ இயக்கவும். நீங்கள் குறிப்பிடும் கோப்பின் முதல் வரியை வாசிக்கச் சொல்லுங்கள். அது கட்டமைப்பு சேமிக்கப்பட்டது என்று மட்டும் கூறாமல் கோப்பு உள்ளடக்கங்களைத் திரும்பத் தர வேண்டும்.

கோப்புகளை வாசிக்க அல்லது கட்டளைகளை இயக்க, அமர்வுக்கு Developer நீட்டிப்பு தேவை. Developer நீட்டிப்பு என்பது goose உள்ளூர் கோப்புகள் மற்றும் கட்டளைகளுடன் வேலை செய்ய அனுமதிக்கும் ஒரு கருவி தொகுதியாகும். இது பொதுவாக இயல்புநிலை கட்டமைப்பில் சேர்க்கப்பட்டுள்ளது. goose-க்கு கோப்பு கருவிகள் இல்லை என்று அது கூறினால், கட்டளையுடன் பின்வருவனவற்றைச் சேர்க்கவும்:

--with-builtin developer

--no-profile-ஐயும் சேர்க்க வேண்டாம், ஏனெனில் அந்த விருப்பம் இயல்புநிலை நீட்டிப்புகளை முடக்குகிறது.

2026-10-09 அன்று சோதனையில், goose 1.54.0 குறிப்பிட்ட கோப்பின் முதல் வரியை வெற்றிகரமாக வாசித்தது. முதல் பதில் சுமார் ஒரு நிமிடம் ஆகலாம்.

பிறகு ஆதாரம் மற்றும் மாதிரி பெயரை உறுதிப்படுத்த OmniProxy கோரிக்கை பதிவுகளைச் சரிபார்க்கவும்.

தொடங்குதல்

ஒரு அமர்வு திறக்கிறது

• goose session
• வழங்குநர் இப்போது சேர்க்கப்பட்டவர்
• மாதிரி பெயர் பட்டியலில் உள்ளது

பணி

அது உண்மையில் பணியை முடித்தது

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

பதிவுகள்

கேட்வேயில் தெரியும்

• ஆவண உதாரணத்திலிருந்து முகவரியைப் பயன்படுத்தவும்
• திறவுகோலை களஞ்சியத்தில் வைக்க வேண்டாம்
• மாதிரி அடையாளம் பட்டியலுடன் பொருந்துகிறது

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

• goose கட்டளையைக் கண்டறிய முடியவில்லை: நிறுவல் பக்கத்தில் விவரிக்கப்பட்டுள்ளபடி நிறுவல் கோப்பகத்தை PATH-இல் சேர்த்து, பிறகு முனையத்தை மீண்டும் திறக்கவும்.
• M3 Mac-இல் டெஸ்க்டாப் பதிப்பில் சாளரம் எதுவும் தோன்றவில்லை: ~/.config-க்கான வாசிப்பு மற்றும் எழுதும் அனுமதிகளைச் சரிபார்க்கவும்.
• கீசெயின் தோல்வியடைகிறது: திறவுகோலை கீரிங்கில் சேமிக்க வேண்டாம்; அதற்குப் பதிலாக சூழல் மாறியைப் பயன்படுத்தவும்.
• மாதிரி பட்டியலில் இல்லை: டெஸ்க்டாப் பதிப்பில், Use custom model என்பதைத் தேர்ந்தெடுத்து மாதிரி பெயரை கைமுறையாக உள்ளிடவும். goose configure தனிப்பயன் மாதிரி பெயரை ஏற்க முடியாது. முனையப் பயன்பாட்டிற்கு, டெஸ்க்டாப் பதிப்பிற்கு மாறவும் அல்லது கட்டமைப்பில் GOOSE_MODEL-ஐ நேரடியாகத் திருத்தவும்.
• முகவரியை அடைய முடியவில்லை: API URL உதாரணத்தில் உள்ளபடி /v1/chat/completions-இல் முடிவடைகிறது என்பதையும், OmniProxy இயங்குகிறது என்பதையும் உறுதிப்படுத்தவும்.
• கோப்புகளை வாசிக்க முடியாது என்று அது கூறுகிறது: Developer நீட்டிப்பைச் சேர்க்கவும் மற்றும் --no-profile-ஐப் பயன்படுத்த வேண்டாம்.
• அது unsupported Responses role: system-ஐத் தருகிறது: முகவரி பொதுவாகச் சரியானது. மாதிரி பட்டியலிலிருந்து மற்றொரு முழு அடையாளத்திற்கு மாறவும்.

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

நிறுவலுக்கு, Install goose-ஐப் பார்க்கவும். தனிப்பயன் வழங்குநர்களுக்கு, goose providers-ஐப் பார்க்கவும். உதாரணங்களில் பயன்படுத்தப்படும் மாதிரி அடையாளங்களுக்கு, xAI models page மற்றும் GPT-6 Luna-ஐப் பார்க்கவும்.

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

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

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