goose इंस्टॉल करना और कस्टम प्रदाता (Custom Provider) कॉन्फ़िगर करना

goose एक सामान्य-उद्देश्य वाला AI असिस्टेंट है जो आपके कंप्यूटर पर चलता है। कोडिंग के अलावा, यह रिसर्च, लेखन, ऑटोमेशन और डेटा व्यवस्थित करने जैसे काम संभाल सकता है। आप इसे डेस्कटॉप ऐप, टर्मिनल या API के माध्यम से उपयोग कर सकते हैं, और डेस्कटॉप व टर्मिनल वर्शन एक ही मॉडल कॉन्फ़िगरेशन साझा करते हैं। यह दोहराव वाले कोडिंग कार्यों के लिए उपयुक्त है और GitHub, डेटाबेस व फ़ाइलों से भी जुड़ सकता है।

शुरू करने से पहले

goose दो इंस्टॉलेशन विकल्प प्रदान करता है: डेस्कटॉप और CLI। डेस्कटॉप एक ग्राफिकल वर्शन है जिसमें विंडो होती है, जबकि CLI का उपयोग टर्मिनल में कमांड दर्ज करके किया जाता है। दोनों एक ही मुख्य कॉन्फ़िगरेशन साझा करते हैं, जिसमें प्रदाता (Provider) और मॉडल शामिल हैं। प्रदाता एक कनेक्शन कॉन्फ़िगरेशन है जो goose को बताता है कि किस मॉडल सेवा का उपयोग करना है।

विंडो चाहिए

goose डेस्कटॉप

macOS पर ज़िप डाउनलोड करें
या brew cask का उपयोग करें
Linux पर इंस्टॉलर पैकेज का उपयोग करें

केवल टर्मिनल

goose CLI

download_cli.sh
या Homebrew CLI
फिर goose session चलाएं

Windows

पहले एक एनवायरनमेंट चुनें

Git Bash या MSYS2
आप PowerShell का भी उपयोग कर सकते हैं
यदि कमांड नहीं मिलता है, तो इसे PATH में जोड़ें

macOS पर, आप इसे ऐप डाउनलोड करके या Homebrew का उपयोग करके इंस्टॉल कर सकते हैं। Linux पर, डेस्कटॉप वर्शन के लिए अपने डिस्ट्रिब्यूशन के पैकेज का उपयोग करें। Windows पर, पहले समर्थित टर्मिनल एनवायरनमेंट की जांच करें।

शुरू करने से पहले, वर्तमान मॉडल सूची से मॉडल ID तैयार रखें। मॉडल ID वह नाम है जिसका उपयोग मॉडल सेवा किसी विशिष्ट मॉडल की पहचान करने के लिए करती है, और इसका उपयोग करते समय आपको पूरा ID कॉपी करना होगा।

पहली बार इंस्टॉल और लॉन्च करना

यदि आप एक ग्राफिकल विंडो चाहते हैं

macOS के लिए दो प्रलेखित इंस्टॉलेशन विधियां हैं:

इंस्टॉलेशन पेज से इसे डाउनलोड करें। पेज macOS Silicon और macOS Intel वर्शन प्रदान करता है। डाउनलोड करने के बाद, ज़िप फ़ाइल को एक्सट्रैक्ट करें और अंदर मौजूद एप्लिकेशन को चलाएं।
वैकल्पिक रूप से, 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

इंस्टॉलेशन के दौरान इंटरैक्टिव कॉन्फ़िगरेशन को छोड़ने के लिए, जोड़ें CONFIGURE=false से पहले bash:

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, जो Windows के लिए Git के साथ शामिल है और अनुशंसित है; 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 का उपयोग करते हैं, तो यह आपसे एक प्रदाता (Provider) कॉन्फ़िगर करने के लिए कहेगा। आप इन-बिल्ट प्रदाताओं को छोड़ सकते हैं और अगले अनुभाग में वर्णित अनुसार एक कस्टम प्रदाता जोड़ सकते हैं। टर्मिनल में, उस डायरेक्टरी पर जाएं जहां आप काम करना चाहते हैं और चलाएं:

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 तक, प्रदाता दस्तावेज़ीकरण में दो संदर्भ ID थे grok-4.7 Grok के लिए और gpt-6-luna OpenAI दस्तावेज़ीकरण से। gpt-6-luna Chat Completions का समर्थन करता है; Chat Completions में फ़ंक्शन कॉलिंग केवल तभी समर्थित है जब reasoning_effort को noneपर सेट किया गया हो। ऐसा नाम कॉपी न करें जो सूची में दिखाई नहीं देता है।

टूल कॉन्फ़िगरेशन दर्ज करें

एक कस्टम प्रदाता OpenAI-, Anthropic-, या Ollama-संगत प्रारूप का उपयोग कर सकता है। संगत प्रारूप का अर्थ है कि टूल एक सामान्य API विनिर्देश के अनुसार अनुरोध भेजता है। OmniProxy से कनेक्ट करते समय, OpenAI Compatible चुनें।

डेस्कटॉप

साइडबार खोलने के लिए ऊपरी-बाएँ कोने में बटन पर क्लिक करें।
Settings पर क्लिक करें।
Models पर क्लिक करें।
Configure providers पर क्लिक करें।
विंडो के नीचे Add Custom Provider पर क्लिक करें।
प्रदाता प्रकार के लिए, OpenAI Compatible चुनें। आप प्रदर्शन नाम (Display Name) को OmniProxy पर सेट कर सकते हैं। API URL में पिछले अनुभाग से पता दर्ज करें। यदि किसी कुंजी की आवश्यकता है, तो API Key की आवश्यकता वाले विकल्प का चयन करें और अपनी OmniProxy कुंजी दर्ज करें। उपलब्ध मॉडल में, मॉडल नाम दर्ज करें, कई नामों को अल्पविराम से अलग करें।
Create Provider पर क्लिक करें।

डेस्कटॉप वर्शन वर्तमान में इस विंडो में कस्टम अनुरोध हेडर को परिभाषित नहीं कर सकता है। यदि आपको अनुरोध हेडर की आवश्यकता है, तो प्रदाता बनाने के बाद कॉन्फ़िगरेशन फ़ाइल को संपादित करें।

टर्मिनल

चलाएं:

goose configure

Custom Providers चुनें, फिर Add A Custom Provider चुनें। API प्रकार के लिए, OpenAI Compatible चुनें, फिर नाम, API URL, कुंजी की आवश्यकता है या नहीं, मॉडल नाम, और स्ट्रीमिंग प्रतिक्रियाएं समर्थित हैं या नहीं, यह दर्ज करने के लिए संकेतों का पालन करें।

Windows पर मैन्युअल रूप से कॉन्फ़िगर करते समय, यदि कीचेन कोई त्रुटि रिपोर्ट करता है, तो इंस्टॉलेशन निर्देश कहते हैं कि कीरिंग में कुंजी को सहेजना अस्वीकार करें और इसके बजाय एक एनवायरनमेंट वेरिएबल का उपयोग करें। फिर चलाएं 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 को परीक्षण में एक फ़ाइल को सफलतापूर्वक पढ़ा।

विंडो

सेटिंग्स

साइडबार में सेटिंग्स
मॉडल पेज
कस्टम प्रदाता जोड़ें

टर्मिनल

goose configure

कस्टम प्रदाता चुनें
फिर जोड़ें चुनें
प्रकार के रूप में OpenAI Compatible चुनें

फ़ाइल

custom_providers

macOS और Linux पर, यह ~/.config के अंतर्गत है
Windows पर, यह APPDATA के अंतर्गत है
आधिकारिक उदाहरण के अनुसार base_url सेट करें

तीनों विधियां एक ही प्रकार का कॉन्फ़िगरेशन बनाती हैं। प्रदाता प्रकार के रूप में OpenAI Compatible चुनें।

वास्तविक कार्य के साथ सत्यापित करें

एक नियमित फ़ाइल वाली डायरेक्टरी खोलें और चलाएं goose session जैसा कि पिछले अनुभाग में दिखाया गया है। इसे आपके द्वारा निर्दिष्ट फ़ाइल की पहली पंक्ति पढ़ने के लिए कहें। इसे केवल यह कहने के बजाय कि कॉन्फ़िगरेशन सहेजा गया था, फ़ाइल सामग्री वापस करनी चाहिए।

फ़ाइलें पढ़ने या कमांड निष्पादित करने के लिए, सत्र को डेवलपर एक्सटेंशन की आवश्यकता होती है। डेवलपर एक्सटेंशन एक टूल मॉड्यूल है जो 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 चल रहा है।
यह कहता है कि यह फ़ाइलें नहीं पढ़ सकता: डेवलपर एक्सटेंशन जोड़ें और --no-profileका उपयोग न करें।
यह वापस करता है unsupported Responses role: system: पता आमतौर पर सही होता है। मॉडल सूची से किसी अन्य पूर्ण ID पर स्विच करें।

आधिकारिक संदर्भ

इंस्टॉलेशन के लिए, Install goose देखें। कस्टम प्रदाताओं के लिए, goose providers देखें। उदाहरणों में उपयोग किए गए मॉडल ID के लिए, xAI models page देखें। और GPT-6 Luna.

अपनी स्वयं की OmniProxy कॉन्फ़िगरेशन से प्रत्येक प्लेसहोल्डर को मान से बदलें। कभी भी एक वास्तविक कुंजी प्रकाशित न करें।

एक सहेजा गया परिणाम या HTTP 200 अकेले पूरी एजेंट संगतता को साबित नहीं करता है। OmniProxy के कॉल रिकॉर्ड में स्रोत और मॉडल जांचें।

आधिकारिक स्रोत · goose ↗