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

ইনস্টলেশনের সময় ইন্টারঅ্যাক্টিভ কনফিগারেশন এড়াতে, যোগ করুন 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 হলো ডিরেক্টরিগুলোর একটি সেট যা টার্মিনাল প্রোগ্রাম খোঁজার জন্য সার্চ করে। যদি ইনস্টলেশন ডিরেক্টরি অন্তর্ভুক্ত না থাকে, তবে আপনি সরাসরি নাম প্রবেশ করিয়ে একটি ইনস্টল করা প্রোগ্রাম চালাতে অক্ষম হতে পারেন।

২০২৬-১০-০৯ তারিখে, CLI ভার্সন ছিল ১.৫৪.০। ডিফল্টভাবে, ইনস্টলেশন স্ক্রিপ্ট প্রোগ্রামটিকে রাখে ~/.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 তালিকা থেকে সম্পূর্ণ মডেলের নাম কপি করুন, যেকোনো স্ল্যাশসহ। ২০২৬-১০-০৯ তারিখে, প্রোভাইডার ডকুমেন্টেশনে দুটি রেফারেন্স 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 নির্বাচন করুন। আপনি ডিসপ্লে নাম OmniProxy হিসেবে সেট করতে পারেন। API URL-এ আগের সেকশন থেকে ঠিকানাটি প্রবেশ করান। যদি একটি কী প্রয়োজন হয়, তবে API Key প্রয়োজন এমন অপশনটি নির্বাচন করুন এবং আপনার OmniProxy কী প্রবেশ করান। Available Models-এ, মডেলের নামগুলো প্রবেশ করান, একাধিক নাম কমা দিয়ে আলাদা করুন। ৭. 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 এর অবশ্যই একটি ভ্যালু থাকতে হবে। এটি একটি প্লেসহোল্ডার স্ট্রিং হতে পারে যা শুধুমাত্র আপনার স্থানীয় কম্পিউটারে ব্যবহৃত হয়। এই কনফিগারেশনটি ২০২৬-১০-০৯ তারিখে পরীক্ষায় সফলভাবে একটি ফাইল পড়েছে।

উইন্ডো

সেটিংস

• সাইডবারে সেটিংস
• মডেল পেজ
• কাস্টম প্রোভাইডার যোগ করুন

টার্মিনাল

goose configure

• কাস্টম প্রোভাইডার নির্বাচন করুন
• তারপর যোগ করুন নির্বাচন করুন
• টাইপ হিসেবে OpenAI Compatible বেছে নিন

ফাইল

custom_providers

• macOS এবং Linux-এ, এটি ~/.config-এর নিচে
• Windows-এ, এটি APPDATA-এর নিচে
• অফিসিয়াল উদাহরণ অনুযায়ী base_url সেট করুন

একটি বাস্তব কাজের সাথে যাচাই করুন

একটি সাধারণ ফাইলযুক্ত ডিরেক্টরি খুলুন এবং চালান goose session যেমন আগের সেকশনে দেখানো হয়েছে। এটিকে আপনার নির্দিষ্ট করা একটি ফাইলের প্রথম লাইন পড়তে বলুন। এটি শুধুমাত্র কনফিগারেশন সেভ হয়েছে তা না বলে ফাইলের বিষয়বস্তু ফেরত দেওয়া উচিত।

ফাইল পড়তে বা কমান্ড কার্যকর করতে, সেশনের জন্য Developer এক্সটেনশন প্রয়োজন। Developer এক্সটেনশন হলো একটি টুল মডিউল যা goose-কে স্থানীয় ফাইল এবং কমান্ডের সাথে কাজ করতে দেয়। এটি সাধারণত ডিফল্ট কনফিগারেশনে অন্তর্ভুক্ত থাকে। যদি goose বলে যে এর কোনো ফাইল টুল নেই, তবে কমান্ডে নিচেরটি যোগ করুন:

--with-builtin developer

এর সাথে যোগ করবেন না --no-profile, কারণ সেই অপশনটি ডিফল্ট এক্সটেনশনগুলো নিষ্ক্রিয় করে।

২০২৬-১০-০৯ তারিখে পরীক্ষায়, goose ১.৫৪.০ সফলভাবে নির্দিষ্ট ফাইলের প্রথম লাইন পড়েছে। প্রথম রেসপন্স আসতে প্রায় এক মিনিট সময় লাগতে পারে।

তারপর উৎস এবং মডেলের নাম নিশ্চিত করতে 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। উদাহরণে ব্যবহৃত মডেল IDগুলোর জন্য, দেখুন xAI models page এবং GPT-6 Luna.

আপনার নিজস্ব OmniProxy কনফিগারেশন থেকে প্রতিটি প্লেসহোল্ডার মান দিয়ে প্রতিস্থাপন করুন। কখনোই একটি বাস্তব কি প্রকাশ করবেন না।

একটি সংরক্ষিত ফলাফল বা HTTP 200 নিজে থেকেই এজেন্টের পূর্ণ সামঞ্জস্যতা প্রমাণ করে না। OmniProxy-এর কল লগে উৎস এবং মডেল পরীক্ষা করুন।

অফিশিয়াল উৎস · goose ↗