goose इन्स्टॉल करणे आणि कस्टम प्रदाता कॉन्फिगर करणे

goose हा एक सामान्य-उद्देशीय AI सहाय्यक आहे जो तुमच्या संगणकावर चालतो. कोडिंग व्यतिरिक्त, तो संशोधन, लेखन, ऑटोमेशन आणि डेटा व्यवस्थापन हाताळू शकतो. तुम्ही ते डेस्कटॉप ॲप, टर्मिनल किंवा API द्वारे वापरू शकता आणि डेस्कटॉप आणि टर्मिनल आवृत्त्या समान मॉडेल कॉन्फिगरेशन सामायिक करतात. हे पुनरावृत्ती होणाऱ्या कोडिंग कार्यांसाठी योग्य आहे आणि GitHub, डेटाबेस आणि फाइल्सशी देखील कनेक्ट होऊ शकते.

सुरुवात करण्यापूर्वी

goose दोन इन्स्टॉलेशन पर्याय ऑफर करते: डेस्कटॉप आणि CLI. डेस्कटॉप ही विंडो असलेली ग्राफिकल आवृत्ती आहे, तर CLI टर्मिनलमध्ये कमांड्स प्रविष्ट करून वापरली जाते. दोन्ही समान मुख्य कॉन्फिगरेशन सामायिक करतात, ज्यामध्ये प्रदाता (Provider) आणि मॉडेल समाविष्ट आहेत. प्रदाता हे कनेक्शन कॉन्फिगरेशन आहे जे goose ला सांगते की कोणते मॉडेल सेवा वापरायची.

विंडो हवी आहे

goose डेस्कटॉप

• macOS वर zip डाउनलोड करा
• किंवा brew cask वापरा
• Linux वर इन्स्टॉलर पॅकेज वापरा

फक्त टर्मिनल

goose CLI

• download_cli.sh
• किंवा Homebrew CLI
• नंतर goose session चालवा

Windows

प्रथम वातावरण निवडा

• Git Bash किंवा MSYS2
• तुम्ही PowerShell देखील वापरू शकता
• कमांड सापडली नाही तर, ती PATH मध्ये जोडा

सुरू करण्यापूर्वी, सध्याच्या मॉडेल सूचीमधील मॉडेल ID तयार ठेवा. मॉडेल ID हे मॉडेल सेवा विशिष्ट मॉडेल ओळखण्यासाठी वापरते, आणि ते वापरताना तुम्हाला पूर्ण ID कॉपी करणे आवश्यक आहे.

प्रथमच इन्स्टॉल आणि लाँच करा

जर तुम्हाला ग्राफिकल विंडो हवी असेल

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

इन्स्टॉलेशन दरम्यान परस्परसंवादी कॉन्फिगरेशन वगळण्यासाठी, जोडा 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 पर्यंत, प्रदाता दस्तऐवजीकरणातील दोन संदर्भ IDs होते grok-4.7 Grok साठी आणि gpt-6-luna OpenAI दस्तऐवजीकरणातून.

gpt-6-luna चॅट कंप्लीशन्सना सपोर्ट करते; चॅट कंप्लीशन्समध्ये फंक्शन कॉलिंग तेव्हाच सपोर्ट केले जाते जेव्हा 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 निवडा. तुम्ही प्रदर्शन नाव (Display Name) OmniProxy वर सेट करू शकता. API URL मध्ये मागील विभागातील पत्ता प्रविष्ट करा. जर की आवश्यक असेल, तर API Key आवश्यक असलेला पर्याय निवडा आणि तुमची OmniProxy की प्रविष्ट करा. उपलब्ध मॉडेल्समध्ये, मॉडेलची नावे प्रविष्ट करा, एकाधिक नावे स्वल्पविरामाने वेगळी करा.
7. Create Provider वर क्लिक करा.

डेस्कटॉप आवृत्ती सध्या या विंडोमध्ये कस्टम विनंती हेडर (request headers) परिभाषित करू शकत नाही. जर तुम्हाला विनंती हेडर्सची आवश्यकता असेल, तर प्रदाता तयार केल्यानंतर कॉन्फिगरेशन फाइल संपादित करा.

टर्मिनल

चालवा:

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 रोजी चाचणीमध्ये फाइल यशस्वीरित्या वाचली.

विंडो

सेटिंग्ज

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

टर्मिनल

goose configure

• कस्टम प्रदाते निवडा
• नंतर जोडा निवडा
• प्रकार म्हणून OpenAI Compatible निवडा

फाइल

custom_providers

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

वास्तविक कार्यासह सत्यापित करा

नियमित फाइल असलेली डिरेक्टरी उघडा आणि चालवा goose session मागील विभागात दर्शविल्याप्रमाणे. त्याला तुम्ही निर्दिष्ट केलेल्या फाइलची पहिली ओळ वाचण्यास सांगा. त्याने कॉन्फिगरेशन जतन केले आहे असे म्हणण्याऐवजी फाइल सामग्री परत केली पाहिजे.

फाइल्स वाचण्यासाठी किंवा कमांड्स कार्यान्वित करण्यासाठी, सत्राला (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. उदाहरणांमध्ये वापरलेल्या मॉडेल IDs साठी, पहा xAI models page आणि GPT-6 Luna.

तुमच्या स्वतःच्या OmniProxy कॉन्फिगरेशनमधील प्रत्येक जागादार मूल्य बदला. वास्तविक की कधीही प्रकाशित करू नका.

संवर्धित परिणाम किंवा HTTP 200 फक्त पूर्ण एजंट सुसंगतता सिद्ध करत नाही. OmniProxy च्या कॉल रेकॉर्डमध्ये स्रोत आणि मॉडेल तपासा.

अधिकृत स्रोत · goose ↗