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 انسٹنس سے ایڈریس، کلید، اور ماڈل کا نام تیار کریں۔ کسٹم پرووائیڈر کی مثال /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 تک، پرووائیڈر دستاویزات میں دو حوالہ جاتی 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 کلید کی ضرورت والا آپشن منتخب کریں اور اپنی 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 سب کمانڈ نہیں ہے۔ آپ GOOSE_PROVIDER اور GOOSE_MODEL ماحول کے متغیرات کے ذریعے --provider اور --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 ↗