Goose + JoinGonka Gateway: আপনার নিজস্ব প্রোভাইডার এবং কি (key) keyring-এ

ধাপ ১: Goose ইনস্টল করুন। প্রোজেক্ট ডকুমেন্টেশনে CLI-এর জন্য অফিসিয়াল পদ্ধতি:

# macOS and Linux: the script puts the binary in ~/.local/bin
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# macOS, Homebrew
brew install block-goose-cli

CONFIGURE=false ভেরিয়েবল goose configure উইজার্ড বন্ধ করে, যা স্ক্রিপ্ট ইনস্টলের পরপর চালু করে: প্রোভাইডার সেট করবে ইনস্টলার। ~/.local/bin ডিরেক্টরি PATH-এ না থাকলে স্ক্রিপ্ট সেটাও জানিয়ে দেবে। Windows-এর জন্য একই রিপোজিটরিতে download_cli.ps1 স্ক্রিপ্ট আছে, আর ডেস্কটপ অ্যাপ ডকুমেন্টেশন পেজ থেকে ডাউনলোড করা যায়; অ্যাপ ও CLI একই সেটিংস পড়ে, তাই নিচের সবকিছু দুটোর জন্যই প্রযোজ্য। যাচাই — goose --version।

ধাপ ২: কী নিন। gate.joingonka.ai/register-এ রেজিস্টার করুন, ঠিকানা নিশ্চিত করুন এবং "API-কী" বিভাগে jg- প্রিফিক্স দিয়ে একটি কী তৈরি করুন। একটি কী ও একটি ব্যালেন্স নেটওয়ার্কের সব মডেলের জন্য কাজ করে।

ধাপ ৩: ইনস্টলার চালান।

npx @joingonka/setup --tool goose

ইনস্টলার কী জিজ্ঞেস করবে — কমান্ড লাইনের আর্গুমেন্টে এটি দেওয়া হয় না, যাতে শেল হিস্ট্রিতে না থেকে যায়, — এবং নিচের কাজ করবে:

• গেটওয়ে ঠিকানা ও নেটওয়ার্কের তিনটি মডেল প্রকৃত কনটেক্সট উইন্ডো সহ custom_providers/custom_joingonka.json প্রোভাইডার ফাইল তৈরি করবে, পারমিশন 600 সহ। custom_joingonka ও CUSTOM_JOINGONKA_API_KEY নামগুলো Goose নিজেই "JoinGonka" নাম থেকে যেভাবে বের করে সেগুলোর মতোই, তাই উইজার্ড থেকে পাওয়া কী ঠিক জায়গায় বসবে;
• JoinGonka-কে ডিফল্ট প্রোভাইডার বানাবে DeepSeek V4 Flash মডেল দিয়ে — তবে শুধু যদি প্রোভাইডার এখনও বেছে না নেওয়া হয় অথবা আমাদেরটি বেছে না নেওয়া হয় খালি বা নেটওয়ার্ক থেকে সরে যাওয়া মডেল দিয়ে। অন্যের পছন্দে হাত দেয় না, বরং চেষ্টা করার কমান্ড ছাপে: goose session --provider custom_joingonka --model …;
• কী secrets.yaml-এ রাখবে, শুধু যদি Goose-এর সিক্রেট স্টোর নিশ্চিতভাবে ফাইল-ভিত্তিক হয়; নাহলে সরাসরি জানাবে যে একধাপ বাকি, — বিস্তারিত কী সংক্রান্ত বিভাগে;
• পরিবর্তিত ফাইলগুলোর ব্যাকআপ নেবে এবং শেষে গেটওয়েতে একটি লাইভ অনুরোধ পাঠাবে, যাতে সাথে সাথেই কী, ঠিকানা ও মডেল যাচাই হয়।

ইনস্টলার সেটিংস ডিরেক্টরি Goose-এর মতোই খুঁজে বের করে: Linux ও macOS-এ ~/.config/goose, Windows-এ %APPDATA%\Block\goose\config, GOOSE_PATH_ROOT সেট থাকলে <root>/config। ভিন্ন মডেল ঠিক করে --model ফ্ল্যাগ, সংক্ষেপে deepseek, glm বা minimax; স্পষ্টভাবে দেওয়া মডেল সবসময় লেখা হয়। প্রশ্নহীন মোডে কী আসে এনভায়রনমেন্ট ভেরিয়েবল থেকে:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool goose --model glm --non-interactive

ইন্সটলার যা কিছু করে, তা ম্যানুয়ালিও লেখা সম্ভব। প্রোভাইডার হলো একটি আলাদা JSON ফাইল ~/.config/goose/custom_providers/custom_joingonka.json; ফাইলের নাম এবং name ফিল্ডের মান একই হতে হবে:

{
  "name": "custom_joingonka",
  "engine": "openai",
  "display_name": "JoinGonka",
  "description": "JoinGonka Gateway — Gonka AI inference (OpenAI-compatible)",
  "api_key_env": "CUSTOM_JOINGONKA_API_KEY",
  "base_url": "https://gate.joingonka.ai/v1/chat/completions",
  "models": [
    { "name": "deepseek-ai/DeepSeek-V4-Flash-0731", "context_limit": 380000 },
    { "name": "zai-org/GLM-5.3-Flash", "context_limit": 390000 },
    { "name": "MiniMaxAI/MiniMax-M2.7", "context_limit": 200000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Goose মডেল এন্ট্রিতে রেসপন্সের জন্য আলাদা কোনো লিমিট নেই। এই ধরনের মডেলের ক্ষেত্রে এটি রিকোয়েস্টে কোনো লিমিট পাঠায় না (আমরা এর রিকোয়েস্ট লগ দেখে যাচাই করেছি) এবং স্ট্রিমিং মোডে গেটওয়ে নিজেই মডেলের লিমিট অনুযায়ী রেসপন্স সীমাবদ্ধ করে: DeepSeek V4 Flash-এর জন্য ৩২,৭৬৮ টোকেন, GLM-5.3 Flash এবং MiniMax M2.7-এর জন্য ৮১৯২ টোকেন। এর জন্য গ্লোবাল ভেরিয়েবল GOOSE_MAX_TOKENS সেট করার প্রয়োজন নেই: এটি সমস্ত প্রোভাইডারের জন্য একই কাজ করে।

Goose প্রোভাইডার ফাইলটিকে কঠোর JSON ফরম্যাটে পড়ে: কোনো কমেন্ট বা অতিরিক্ত কমা থাকলে প্রোভাইডার তালিকা থেকে অদৃশ্য হয়ে যায়। এটি উইজার্ড (goose configure → Custom Providers) দিয়েও তৈরি করা যায়, কিন্তু উইজার্ড কনটেক্সট উইন্ডো সম্পর্কে জিজ্ঞাসা করে না — এটি ম্যানুয়ালি যোগ করতে হবে।

ডিফল্ট প্রোভাইডার এবং মডেল ~/.config/goose/config.yaml এ থাকে। Goose নিজেই এভাবেই রেকর্ড করে:

active_provider: custom_joingonka
providers:
  custom_joingonka:
    enabled: true
    model: deepseek-ai/DeepSeek-V4-Flash-0731
    configured: true

পুরোনো লেআউট — ফাইলের মূলে ফ্ল্যাট কী GOOSE_PROVIDER এবং GOOSE_MODEL — তাও কাজ করে: Goose এটি পড়ে এবং সেটিংস প্রথমবার সেভ করার সময় নিজে থেকেই নতুন ফরম্যাটে রূপান্তর করে, যেমনটি আমাদের goose configure করার পর হয়েছে। ফাঁকা ফাইলের ক্ষেত্রে ইন্সটলার ফ্ল্যাট কীগুলোই লেখে — যেকোনো ভার্সন এগুলো বুঝতে পারে। একই নামের এনভায়রনমেন্ট ভেরিয়েবল ফাইলের চেয়ে বেশি গুরুত্বপূর্ণ: যদি সেগুলো শেলের মধ্যে সেট করা থাকে, তবে config.yaml এর সিলেকশন কাজ করবে না এবং ইন্সটলার এ সম্পর্কে সতর্ক করবে।

Goose-এর প্রোভাইডার ফাইলে শুধু সিক্রেটের নাম আছে — CUSTOM_JOINGONKA_API_KEY। মানটি সে ক্রমানুসারে খোঁজে: প্রথমে এই নামের এনভায়রনমেন্ট ভেরিয়েবলে, তারপর সিস্টেমের সিক্রেট স্টোরেজে (keyring, macOS-এ — Keychain), তারপর কনফিগের পাশে secrets.yaml ফাইলে। Goose-এর স্টোরেজ ফাইল-ভিত্তিক হলে সিক্রেটগুলো ওই ফাইলে যায় এবং সেখানে সাদা টেক্সটে, 600 পারমিশনসহ থাকে। আর config.yaml-এ Goose কী খোঁজেই না (ডকুমেন্টেশন)।

keyring বন্ধ থাকলে স্টোরেজ ফাইল-ভিত্তিক হয়ে যায় — GOOSE_DISABLE_KEYRING ভেরিয়েবলে যেকোনো মান বা config.yaml-এ GOOSE_DISABLE_KEYRING: true লেখা থাকলে, — অথবা keyring অনুপলব্ধ হলে: গ্রাফিক্যাল সেশন ছাড়া সার্ভার, কন্টেইনার, CI। দ্বিতীয় ক্ষেত্রে Goose লগে লেখে «Keyring unavailable. Using file storage for secrets.» এবং নিজেই ফাইলে চলে যায় — কন্টেইনারে ঠিক এটাই দেখেছি আমরা। ইনস্টলার keyring-এ লিখতে পারে না, আর আপনার হয়ে সেটি বন্ধও করবে না: তাহলে Goose সেখানে আগে থেকে থাকা সিক্রেটগুলো দেখা বন্ধ করে দিত। এখান থেকেই সিনারিওগুলো:

বাকি থাকা ধাপ। goose configure চালান এবং উইজার্ডের প্রশ্নগুলোর উত্তর দিন — আমাদের রানে এগুলো এমন দেখাচ্ছিল:

• What would you like to configure? → Configure Providers;
• Which model provider should we use? → JoinGonka (আমাদের ক্ষেত্রে এটি প্রথমে ছিল);
• Would you like to set CUSTOM_JOINGONKA_API_KEY? (optional) → Yes, তারপর Enter value for CUSTOM_JOINGONKA_API_KEY-এ কী-টি পেস্ট করুন — অক্ষরের বদলে বর্গাকার চিহ্ন দেখাবে। কী-টি সঙ্গে সঙ্গে সেভ হয়ে যায়;
• Would you like to configure advanced settings? → No;
• Select a model — তালিকাটি Goose গেটওয়ে থেকে পায়: MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731, zai-org/GLM-5.3-Flash. কার্সর প্রথম লাইনে থাকে — ইনস্টলারের বেছে নেওয়া মডেলটি রাখতে তীরচিহ্ন দিয়ে DeepSeek V4 Flash নির্বাচন করুন। একটি যাচাইকরণ অনুরোধের পর উইজার্ড «Configuration saved successfully» লাইন দিয়ে শেষ হবে।

Goose Desktop-এ পথটি এমন: Settings → Models → Configure providers → JoinGonka → কী → Submit। হাতে হাতে কী পেস্ট করতে না চাইলে এনভায়রনমেন্ট ভেরিয়েবলে রাখুন এবং একই শেল থেকে উইজার্ড চালান: Goose লিখবে «CUSTOM_JOINGONKA_API_KEY is set via environment variable» এবং মানটি সেভ করার প্রস্তাব দেবে:

read -s CUSTOM_JOINGONKA_API_KEY && export CUSTOM_JOINGONKA_API_KEY
goose configure

আর শুধু একবার চালানোর জন্য কী-টি সেভ না করেই দেওয়া যায়: CUSTOM_JOINGONKA_API_KEY=jg-your-key goose session, PowerShell-এ — $env:CUSTOM_JOINGONKA_API_KEY = "jg-your-key"; goose session. এনভায়রনমেন্ট ভেরিয়েবল সেভ করা মানের চেয়ে প্রাধান্য পায়, কিন্তু শেল বন্ধ হওয়ার আগ পর্যন্তই টেকে।

প্রথমে দেখুন Goose আসলে কী কী সেটিংস দেখতে পাচ্ছে:

goose info -v

«goose Configuration» ব্লকে GOOSE_PROVIDER: custom_joingonka এবং মডেল আইডিসহ GOOSE_MODEL লাইন থাকতে হবে। এরপর — ইন্টারঅ্যাকটিভ সেশন ছাড়াই একবার চালান: একটি খালি ডিরেক্টরিতে স্পষ্ট বাগযুক্ত একটি ফাইল রাখুন এবং সেটি খুঁজে বের করতে বলুন।

goose run --no-session -t "Read calc.py and tell me in one sentence whether it has a bug."

--no-session ফ্ল্যাগ রানটি ইতিহাসে সংরক্ষণ করে না। হেডারে ● new session · custom_joingonka deepseek-ai/DeepSeek-V4-Flash-0731-এর মতো একটি লাইন দেখাবে, তারপর টুল কল — cat calc.py কমান্ডসহ ▸ shell — এবং পাওয়া বাগসহ উত্তর। একবার চলানোর জন্য অন্য মডেল নির্ধারণ করে --model: zai-org/GLM-5.3-Flash বা MiniMaxAI/MiniMax-M2.7। ২০২৬ সালের ২৩ সেপ্টেম্বরের আমাদের রানে নেটওয়ার্কের তিনটি মডেলই «অনুরোধ → টুল → ফলাফল → উত্তর» চক্রটি সম্পন্ন করেছে। Goose CLI ডিফল্টভাবে মডেলের যুক্তি প্রদর্শন লুকায় — আউটপুট টার্মিনালে গেলে GOOSE_CLI_SHOW_THINKING=1 ভেরিয়েবল দিয়ে সেগুলো দেখানো যায়। গেটওয়ের দিক থেকে অনুরোধটি ড্যাশবোর্ডে দেখা যায়: «ব্যবহার» বিভাগ, «মডেল অনুযায়ী» এবং «কী অনুযায়ী» বিশ্লেষণ।

কিছু ভুল হলে, সাধারণত বার্তা থেকেই সমস্যাটি বোঝা যায়:

একটি এজেন্ট চ্যাটের চেয়ে ভিন্নভাবে টোকেন খরচ করে। স্ট্যান্ডার্ড কনফিগারেশনে, Goose মডেলকে আঠারোটি অন্তর্নির্মিত টুলের বিবরণ পাঠায় এবং আমাদের রানে প্রতিটি পদক্ষেপে আপনার প্রশ্নের আগেই প্রায় ৪.৬ হাজার ইনপুট টোকেন খরচ হচ্ছিল। "একটি ফাইল পড়ুন এবং ভুল খুঁজে বের করুন" কাজটি দুই থেকে তিনটি ধাপ এবং ১০-১৫ হাজার টোকেন নিয়েছে, যার প্রায় সবই ইনপুট; সেশনের নাম তৈরি করার জন্য Goose নিজেই আরও একটি সংক্ষিপ্ত অনুরোধ করে। অপ্রয়োজনীয় এক্সটেনশনগুলো goose configure → Toggle Extensions-এ বন্ধ করা যায় — ইনপুট কমানোর এটি সবচেয়ে সহজ উপায়।

JoinGonka Gateway-এর মাধ্যমে টোকেনের খরচ প্রতি মিলিয়নে $0.0069 ইনপুট এবং প্রতি মিলিয়নে $0.021 আউটপুট — দাম নেটওয়ার্কের সব মডেলের জন্য একই এবং এই পৃষ্ঠায় লাইভ সোর্স থেকে নেওয়া হয়।

ডান কলামের অনুমানগুলো ২০২৬ সালের সেপ্টেম্বরের দাম অনুযায়ী। তুলনার জন্য — Goose-এ মডেলের জন্য যেভাবে পেমেন্ট করা যায়:

সঠিক খরচ এবং ব্যালেন্স ক্যাবিনেটের "Usage" এবং "Billing" বিভাগে দেখা যায়। কেন ডিফল্টভাবে DeepSeek V4 Flash সেট করা আছে — যার নেটওয়ার্কে সবচেয়ে বড় আউটপুট লিমিট আছে — তা মডেলের রিভিউতে বিস্তারিত আলোচনা করা হয়েছে।

নিশ্চিতকরণ মোড। ডিফল্টভাবে Goose auto মোডে চলে — সম্পূর্ণ স্বায়ত্তশাসিত: নিজেই ফাইল সম্পাদনা ও মুছে ফেলে, কমান্ড চালায় এবং এক্সটেনশন ব্যবহার করে, কিছু জিজ্ঞাসা না করেই। নিজের প্রজেক্টে এটি সুবিধাজনক, কিন্তু অন্যের কোডে মোডটি কঠোর করা ভালো:

# inside a session
/mode smart_approve

# permanently, as a line in config.yaml
GOOSE_MODE: smart_approve

এটি Goose-এর নিজস্ব বৈশিষ্ট্য, মডেল প্রোভাইডারের উপর নির্ভর করে না।

মডেল পরিবর্তন। সেশনের ভিতরে — আইডিসহ /model কমান্ড, যেমন /model zai-org/GLM-5.3-Flash; একটি রানের জন্য — goose run এবং goose session-এ --model ফ্ল্যাগ; স্থায়ীভাবে — goose configure বা config.yaml-এ model লাইন। প্রোভাইডার তখনও আগেরটিই থাকে। চিন্তাশীল GLM-5.3 Flash জটিল লজিকের জন্য ভালো, তবে তার উত্তরের সীমা — 8192 টোকেন, আর এর একটি অংশ চিন্তায় চলে যায় — বিস্তারিত মডেল পর্যালোচনায়।

নজরদারিহীন রান। goose run স্ক্রিপ্ট ও CI-এর জন্য উপযুক্ত: -q ফ্ল্যাগ আউটপুটে কেবল মডেলের উত্তর রাখে, --output-format json বিশ্লেষণের জন্য ফলাফল দেয়। --max-turns (মানুষের অংশগ্রহণ ছাড়া এজেন্ট কত ধাপ চলে) এবং --max-tool-repetitions (একই আর্গুমেন্টসহ একটি টুল পরপর কতবার কল করা যায়) সীমাবদ্ধতাগুলো লুপে আটকে যাওয়া থেকে রক্ষা করে।

গোপনীয়তা। Goose-এ বেনামি ব্যবহারের পরিসংখ্যান ডিফল্টভাবে বন্ধ (GOOSE_TELEMETRY_ENABLED)। গেটওয়ে প্রম্পট ও উত্তরের বিষয়বস্তু সংরক্ষণ করে না — পরিসংখ্যানে কেবল খরচের সমষ্টি থাকে।