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 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, जे 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-4.7 Grok साठी आणि gpt-6-luna OpenAI दस्तऐवजीकरणातून. gpt-6-luna Chat Completions ला सपोर्ट करतो; 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 निवडा. तुम्ही Display Name OmniProxy वर सेट करू शकता. API URL मध्ये मागील विभागातील ॲड्रेस प्रविष्ट करा. जर की आवश्यक असेल, तर API Key आवश्यक असलेला पर्याय निवडा आणि तुमची OmniProxy की प्रविष्ट करा. Available Models मध्ये, मॉडेलची नावे प्रविष्ट करा, एकाधिक नावे स्वल्पविरामाने वेगळी करा.
7. 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 सेट करा

प्रत्यक्ष कामासह पडताळणी करा

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

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

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

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