goose کی تنصیب اور کسٹم پرووائیڈر کی کنفیگریشن

goose ایک عام مقصد کا AI اسسٹنٹ ہے جو آپ کے کمپیوٹر پر چلتا ہے۔ کوڈنگ کے علاوہ، یہ تحقیق، تحریر، آٹومیشن، اور ڈیٹا آرگنائزیشن کو سنبھال سکتا ہے۔ آپ اسے ڈیسک ٹاپ ایپ، ٹرمینل، یا API کے ذریعے استعمال کر سکتے ہیں، اور ڈیسک ٹاپ اور ٹرمینل ورژنز ایک ہی ماڈل کنفیگریشن کا اشتراک کرتے ہیں۔ یہ دہرائے جانے والے کوڈنگ کے کاموں کے لیے موزوں ہے اور GitHub، ڈیٹا بیسز، اور فائلوں سے بھی جڑ سکتا ہے۔

شروع کرنے سے پہلے

goose تنصیب کے دو اختیارات پیش کرتا ہے: ڈیسک ٹاپ اور CLI۔ ڈیسک ٹاپ ایک ونڈو والا گرافیکل ورژن ہے، جبکہ CLI ٹرمینل میں کمانڈز درج کر کے استعمال کیا جاتا ہے۔ دونوں ایک ہی بنیادی کنفیگریشن کا اشتراک کرتے ہیں، بشمول پرووائیڈر اور ماڈل۔ پرووائیڈر وہ کنکشن کنفیگریشن ہے جو goose کو بتاتی ہے کہ کون سی ماڈل سروس استعمال کرنی ہے۔

ونڈو چاہتے ہیں

goose ڈیسک ٹاپ

• macOS پر زپ ڈاؤن لوڈ کریں
• یا brew cask استعمال کریں
• Linux پر انسٹالر پیکیج استعمال کریں

صرف ٹرمینل

goose CLI

• download_cli.sh
• یا Homebrew CLI
• پھر goose session چلائیں

Windows

پہلے ماحول کا انتخاب کریں

• Git Bash یا MSYS2
• آپ PowerShell بھی استعمال کر سکتے ہیں
• اگر کمانڈ نہ ملے تو اسے PATH میں شامل کریں

شروع کرنے سے پہلے، موجودہ ماڈل لسٹ سے ماڈل ID تیار رکھیں۔ ماڈل ID وہ نام ہے جو ماڈل سروس کسی مخصوص ماڈل کی شناخت کے لیے استعمال کرتی ہے، اور اسے استعمال کرتے وقت آپ کو مکمل ID کاپی کرنی ہوگی۔

پہلی بار تنصیب اور لانچ

اگر آپ گرافیکل ونڈو چاہتے ہیں

macOS کے لیے تنصیب کے دو دستاویزی طریقے ہیں:

• اسے انسٹالیشن صفحہ سے ڈاؤن لوڈ کریں۔ صفحہ macOS سلیکون اور macOS انٹیل ورژنز فراہم کرتا ہے۔ ڈاؤن لوڈ کرنے کے بعد، زپ فائل کو نکالیں اور اندر موجود ایپلی کیشن چلائیں۔
• متبادل کے طور پر، 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 ڈیسک ٹاپ ورژن کے لیے، اسے انسٹالیشن صفحہ سے ڈاؤن لوڈ کریں، زپ فائل نکالیں، اور اندر موجود ایپلی کیشن چلائیں۔

اگر آپ صرف ٹرمینل ورژن چاہتے ہیں

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 انسٹینس سے ایڈریس، کلید، اور ماڈل کا نام تیار کریں۔ کسٹم پرووائیڈر کی مثال base_url استعمال کرتی ہے جو /v1/chat/completions پر ختم ہوتا ہے، لہذا یہ گائیڈ اسی فارمیٹ کی پیروی کرتی ہے:

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 تک، پرووائیڈر دستاویزات میں دو حوالہ جاتی IDs Grok کے لیے grok-4.7 اور OpenAI دستاویزات سے gpt-6-luna تھیں۔ gpt-6-luna چیٹ تکمیلات (Chat Completions) کو سپورٹ کرتا ہے؛ چیٹ تکمیلات میں فنکشن کالنگ صرف تب سپورٹ کی جاتی ہے جب reasoning_effort کو none پر سیٹ کیا جائے۔ ایسا نام کاپی نہ کریں جو لسٹ میں ظاہر نہ ہو۔

ٹول کنفیگریشن درج کریں

ایک کسٹم پرووائیڈر OpenAI-، Anthropic-، یا Ollama-مطابقت پذیر فارمیٹ استعمال کر سکتا ہے۔ مطابقت پذیر فارمیٹ کا مطلب ہے کہ ٹول ایک عام API تفصیلات کے مطابق درخواستیں بھیجتا ہے۔ OmniProxy سے جڑتے وقت، OpenAI Compatible منتخب کریں۔

ڈیسک ٹاپ

1. سائیڈ بار کھولنے کے لیے اوپر بائیں کونے میں بٹن پر کلک کریں۔
2. Settings پر کلک کریں۔
3. Models پر کلک کریں۔
4. Configure providers پر کلک کریں۔
5. ونڈو کے نچلے حصے میں Add Custom Provider پر کلک کریں۔
6. پرووائیڈر کی قسم کے لیے، OpenAI Compatible منتخب کریں۔ آپ ڈسپلے کا نام OmniProxy پر سیٹ کر سکتے ہیں۔ API URL میں پچھلے سیکشن سے ایڈریس درج کریں۔ اگر کلید درکار ہے، تو API Key درکار ہونے والا آپشن منتخب کریں اور اپنی OmniProxy کلید درج کریں۔ دستیاب ماڈلز میں، ماڈل کے نام درج کریں، متعدد ناموں کو کوما کے ساتھ الگ کریں۔
7. Create Provider پر کلک کریں۔

ڈیسک ٹاپ ورژن فی الحال اس ونڈو میں کسٹم ریکویسٹ ہیڈرز کی وضاحت نہیں کر سکتا۔ اگر آپ کو ریکویسٹ ہیڈرز کی ضرورت ہے، تو پرووائیڈر بنانے کے بعد کنفیگریشن فائل میں ترمیم کریں۔

ٹرمینل

چلائیں:

goose configure

Custom Providers منتخب کریں، پھر Add A Custom Provider منتخب کریں۔ API کی قسم کے لیے، 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 کی قدر کو لسٹ سے مکمل ID کے ساتھ تبدیل کریں۔ goose session میں start سب کمانڈ نہیں ہے۔ آپ --provider اور --model کو GOOSE_PROVIDER اور GOOSE_MODEL ماحولیاتی متغیرات کے ذریعے بھی سیٹ کر سکتے ہیں۔ یہاں تک کہ اگر گیٹ وے کیز کی توثیق نہیں کرتا ہے، تب بھی OMNIPROXY_API_KEY کی قدر ہونی چاہیے۔ یہ صرف آپ کے مقامی کمپیوٹر پر استعمال ہونے والی پلیس ہولڈر سٹرنگ ہو سکتی ہے۔ اس کنفیگریشن نے 2026-10-09 کو ٹیسٹنگ میں کامیابی کے ساتھ ایک فائل پڑھی۔

ونڈو

Settings

• سائیڈ بار میں Settings
• Models صفحہ
• Add Custom Provider

ٹرمینل

goose configure

• Custom Providers منتخب کریں
• پھر add منتخب کریں
• قسم کے طور پر 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
• پرووائیڈر وہی ہے جو ابھی شامل کیا گیا ہے
• ماڈل کا نام لسٹ میں ہے

کام

اس نے حقیقت میں کام مکمل کیا

• مثال کے طور پر، موجودہ ڈائریکٹری لسٹ کریں
• اس کے جواب کا جائزہ لیں
• صرف کامیاب سیو پر انحصار نہ کریں

لاگز

گیٹ وے میں نظر آتے ہیں

• دستاویزی مثال سے ایڈریس استعمال کریں
• کلید کو ریپوزٹری میں نہ رکھیں
• ماڈل ID لسٹ سے مماثل ہے

عام غلطیاں

• 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 واپس کرتا ہے: ایڈریس عام طور پر درست ہوتا ہے۔ ماڈل لسٹ سے کسی اور مکمل ID پر سوئچ کریں۔

سرکاری حوالہ جات

تنصیب کے لیے، Install goose دیکھیں۔ کسٹم پرووائیڈرز کے لیے، goose providers دیکھیں۔ مثالوں میں استعمال ہونے والے ماڈل IDs کے لیے، xAI models page اور GPT-6 Luna دیکھیں۔

اپنے ذاتی OmniProxy ترتیب سے ہر پلیس ہولڈر کو ویلیوز سے تبدیل کریں۔ کبھی بھی ایک حقیقی کنج شائع نہ کریں۔

محض محفوظ نتیجہ یا HTTP 200 مکمل ایجنٹ مطابقت کی ضمانت نہیں دیتا۔ OmniProxy کی کال ریکارڈ میں ذریعہ اور ماڈل چیک کریں۔

سرکاری ذرائع · goose ↗