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

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 নির্বাচন করুন।

ডেস্কটপ

1. সাইডবার খুলতে উপরের বাম কোণের বোতামে ক্লিক করুন।
2. Settings ক্লিক করুন।
3. Models ক্লিক করুন।
4. Configure providers ক্লিক করুন।
5. উইন্ডোর নিচে Add Custom Provider ক্লিক করুন।
6. প্রোভাইডার টাইপের জন্য, OpenAI Compatible নির্বাচন করুন। আপনি ডিসপ্লে নাম 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 যেমন আগের সেকশনে দেখানো হয়েছে। এটিকে আপনার নির্দিষ্ট করা একটি ফাইলের প্রথম লাইন পড়তে বলুন। এটি শুধুমাত্র কনফিগারেশন সেভ হয়েছে তা না বলে ফাইলের বিষয়বস্তু ফেরত দেওয়া উচিত।

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

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

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

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