Zoo Code + JoinGonka Gateway: Roo Code থেকে Gonka মডেলে মাইগ্রেশন

ধাপ ১: এক্সটেনশন ইনস্টল করুন। VS Code-এ এক্সটেনশন প্যানেল খুলুন (Ctrl+Shift+X, macOS-এ Cmd+Shift+X), «Zoo Code» খুঁজুন এবং Zoo Code Organization প্রকাশকের এক্সটেনশন ইনস্টল করুন। একই কাজ একটি কমান্ডে:

code --install-extension ZooCodeOrganization.zoo-code

VS Code 1.100 বা নতুন প্রয়োজন — এক্সটেনশন ম্যানিফেস্টে এটাই বলা আছে; VSCodium, Windsurf এবং Marketplace ছাড়া অন্য এডিটরগুলোর জন্য এক্সটেনশনটি Open VSX-এ প্রকাশিত। স্থিতিশীল চ্যানেলের (১৮ সেপ্টেম্বর ২০২৬-এর 3.82.2) পাশাপাশি প্রাথমিক 3.83.x আছে — মূল শাখার নাইটলি বিল্ড; কাজের জন্য স্থিতিশীলটি নিন। ইনস্টলেশনের পর অ্যাক্টিভিটি বারে Zoo Code আইকন দেখা যাবে।

ধাপ ২: কী নিন। gate.joingonka.ai/register-এ রেজিস্টার করুন, ঠিকানা নিশ্চিত করুন এবং «API কীজ» বিভাগে jg- প্রিফিক্সসহ একটি কী তৈরি করুন। Zoo Code-এর জন্য আলাদা কী রাখা সুবিধাজনক: এর খরচ পরিসংখ্যানে আলাদা লাইনে দেখা যাবে।

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

npx @joingonka/setup --tool zoo --model deepseek

ইনস্টলার কী জিজ্ঞাসা করবে — কমান্ড-লাইনের আর্গুমেন্টে এটি পাঠানো হয় না, যাতে শেলের ইতিহাসে থেকে না যায়। এটির লেখার কিছু নেই: প্রদানকারীর প্রোফাইলগুলো কীসহ Zoo Code VS Code-এর সুরক্ষিত সিক্রেট স্টোরেজে রাখে, ফাইলে নয়। তাই ইনস্টলার ফর্মের জন্য প্রস্তুত মান এবং নির্বাচিত মডেলের প্রকৃত সীমা প্রিন্ট করে:

Zoo Code is configured in the VS Code extension UI (no file is written).
Open the Zoo Code settings (gear icon) → API Provider, then enter:

  API Provider: OpenAI Compatible
  Base URL:     https://gate.joingonka.ai/v1
  API Key:      jg-your-key
  Model:        deepseek-ai/DeepSeek-V4-Flash-0731

Then set the real limits of this model under Model Configuration
(the defaults do not fit any Gonka model):

  Context Window Size: 380000
  Max Output Tokens:   32768
  Image Support:       off

Zoo Code relies on native tool calling only — all our Gonka models support it.

এরপর গেটওয়েতে লাইভ অনুরোধের ফলাফল আসে — সফল হলে লাইনটি ✓ Verified: the gateway accepted the key, base URL and model. কী, ঠিকানা এবং মডেল প্রথম কাজেই নয়, সাথে সাথেই যাচাই হয়। প্রিন্ট করা ব্লকে কীটি সম্পূর্ণ থাকে যাতে সহজে কপি করা যায় — এই আউটপুট প্রকাশ করবেন না।

--model ফ্ল্যাগ ছাড়া ইনস্টলার MiniMax M2.7 বসাবে: যেখানে মডেল ম্যানুয়ালি বেছে নিতে হয়, সেখানে এটি নেটওয়ার্কের সর্বোচ্চ ক্ষমতার মডেল প্রস্তাব করে। Zoo Code-এর জন্য DeepSeek V4 Flash দিয়ে শুরু করার পরামর্শ দিই: আমাদের পরীক্ষায় টুলের ফলাফলের পরের ধাপটি এটি প্রথম অনুরোধেই সম্পন্ন করেছে — বিস্তারিত যাচাই বিভাগে; ফ্ল্যাগটি সংক্ষেপ glm (GLM-5.3 Flash) এবং minimax-ও গ্রহণ করে। --tool ফ্ল্যাগ ছাড়া ইনস্টলার 25টি টুলের মেনু দেখাবে।

ফর্মের একটি বিবরণ: Zoo Code 3.82.2-এ Model Configuration শিরোনামের আলাদা ব্লক নেই। সীমার ফিল্ডগুলো একই ফর্মে নিচে, «Configure the capabilities and pricing for your custom OpenAI-compatible model» ব্যাখ্যার নিচে থাকে, এবং Max Output Tokens আগে, Context Window Size পরে।

প্রথমবার চালু করার সময়, Zoo Code একটি স্বাগত বার্তা এবং Choose your provider বোতাম দেখায়: এটি একটি ফর্মে নিয়ে যায় যেখানে আগে থেকেই OpenRouter নির্বাচিত থাকে — প্রোভাইডার পরিবর্তন করে OpenAI Compatible করুন এবং শেষে Finish এ ক্লিক করুন। পরে একই ফর্ম Zoo Code প্যানেলের শিরোনামে গিয়ার আইকনের মাধ্যমে খোলা যায়, Providers বিভাগে; পরিবর্তনগুলো Save বোতাম দিয়ে সংরক্ষণ করতে হয়।

নেটওয়ার্ক মডেলের লিমিট:

অন্যান্য বিষয়গুলো পরিবর্তন না করাই ভালো: Enable streaming এবং Include max output tokens চালু রাখুন, Enable R1 model parameters এবং Use Azure বন্ধ রাখুন (এগুলো R1 ফ্যামিলির মডেল এবং Azure OpenAI-এর জন্য), Custom Headers এবং Extra Body ফিল্ডগুলো খালি রাখুন।

লিমিটগুলো মডেলের পরিবর্তে প্রোফাইলে সংরক্ষিত থাকে: যদি একই প্রোফাইলে Model পরিবর্তন করেন, তবে উইন্ডো এবং আউটপুট লিমিট আগের মতোই থেকে যাবে। তাই প্রতিটি মডেলের জন্য আলাদা প্রোফাইল তৈরি করা সুবিধাজনক — এ সম্পর্কে পরের সেকশনে আলোচনা করা হয়েছে।

Zoo Code তৈরি হয়েছে Roo Code-এর কোডবেস থেকে, তাই মাইগ্রেশন করতে কয়েক মিনিট সময় লাগে এবং প্রকল্পের ফাইলগুলোতে হাত দেওয়ার প্রয়োজন হয় না। অফিসিয়াল মাইগ্রেশন গাইড-এ সেটিংস এক্সপোর্ট এবং ইমপোর্টের বর্ণনা দেওয়া হয়েছে; বাকিগুলো একটি আলাদা বোতামের মাধ্যমে বা পুরোনো পাথ থেকে পড়া যায়:

Roo Code প্রোফাইল যা আগে থেকেই JoinGonka Gateway-এর সাথে যুক্ত ছিল, তা অ্যাড্রেস, কী, মডেল এবং লিমিট সহ স্থানান্তর হবে — শুধু চেক করে নিন যে মডেলটি এখন নেটওয়ার্কে আছে কিনা: তালিকাটি GET https://gate.joingonka.ai/v1/models কমান্ডের মাধ্যমে পাওয়া যায়।

মোড এবং প্রোফাইল। পাঁচটি বিল্ট-ইন মোড রয়েছে: Code, Debug, Architect (শুধুমাত্র Markdown-ফাইল এডিট করে), Ask (এডিট ছাড়া উত্তর দেয়) এবং Orchestrator (অন্য মোডগুলোর জন্য সাব-টাস্ক বণ্টন করে)। এগুলো ইনপুট ফিল্ডের পাশে লিস্ট থেকে পরিবর্তন করা যায়, বার্তার শুরুতে মোডের নাম কমান্ড হিসেবে লিখে, উদাহরণস্বরূপ /architect, অথবা Ctrl+. (macOS-এ Cmd+.) শর্টকাট দিয়ে। প্রতিটি মোড সেই প্রোফাইলটি মনে রাখে যা আপনি সর্বশেষ ব্যবহার করেছিলেন, এবং মোড পরিবর্তন করলে Zoo Code স্বয়ংক্রিয়ভাবে প্রোফাইল স্যুইচ করে।

এখান থেকে একটি সুবিধাজনক স্কিম তৈরি হয়: প্রতিটি মডেলের জন্য আলাদা প্রোফাইল যা নির্দিষ্ট মোডের সাথে সংযুক্ত। Settings → Providers-এ Configuration Profile ফিল্ডের পাশে «+» এ ক্লিক করুন, প্রোফাইলটির নাম দিন, যেমন Gonka DeepSeek, এবং ফর্মটি পূরণ করুন; GLM-5.3 Flash এবং MiniMax M2.7-এর জন্য পুনরায় করুন — সবার ঠিকানা এবং কী একই। এরপর প্রতিটি মোডে ইনপুট ফিল্ডের পাশে প্রোফাইল লিস্ট থেকে প্রোফাইল নির্বাচন করুন, মোডটি তা মনে রাখবে। এই লিস্টের লক আইকনটি উল্টো কাজ করে, এটি ওয়ার্কিং ফোল্ডারের সমস্ত মোডের জন্য একটি নির্দিষ্ট প্রোফাইলকে লক করে দেয়।

যুক্তি (Reasoning) লেভেল। ফর্মে Enable Reasoning Effort চেকটি Low, Medium, High, Extra High এবং Max তালিকাটি খোলে; এটি অফ থাকলে, লেভেলটি রিকোয়েস্টে যায় না। GLM-5.3 Flash-এর সুইচটি মূলত বাইনারি: Low যুক্তি বন্ধ করে, অন্য যেকোনো লেভেল এটিকে পূর্ণ রাখে — দ্রুত প্রশ্নের জন্য আলাদা Low GLM প্রোফাইল রাখা সুবিধাজনক। বিস্তারিত দেখুন GLM-5.3 Flash রিভিউ-তে। DeepSeek V4 Flash এবং MiniMax M2.7-এর জন্য গেটওয়ে স্কেলটি নতুন করে লেখে না: লেভেলটি কীভাবে কাজ করবে তা মডেলের উপর নির্ভর করে।

একটি ছোট ফাইল সম্বলিত ফোল্ডার খুলুন যেখানে একটি স্পষ্ট ভুল আছে, উদাহরণস্বরূপ calc.py একটি যোগ করার ফাংশন সহ যা বিয়োগ করে, এবং Code মোডে লিখুন: "calc.py পড়ুন এবং এক বাক্যে বলুন এতে কোনো ভুল আছে কি না"। Zoo Code ফাইলটি পড়ার অনুমতি চাইবে — "Zoo wants to read this file", এবং Approve ও Deny বোতাম দেখাবে, যদি না আগে থেকেই Auto-Approve-এ অনুমতি দেওয়া থাকে। এরপর মডেলটি কমপ্লিশন টুল কল করবে এবং টাস্কটি Task Completed ব্লকের মাধ্যমে উত্তরের সাথে শেষ হবে; যদি কোনো যুক্তি থাকে, তবে তা আলাদা Thinking ব্লকে দেখানো হবে। টাস্কের ছোট হেডারে কনটেক্সট ফিলিং শতাংশ Context Window Size থেকে গণনা করা হয় — এটি সঠিকভাবে সেট করার আরেকটি কারণ।

আমরা Zoo Code এর নমুনা অনুসরণ করে এই প্রবাহটি তৈরি করেছি — স্ট্রিম, কঠোর স্কিমায় টুলস এবং ইতিহাসে read_file এর ফলাফল। DeepSeek V4 Flash সঠিক আউটপুটের সাথে নেটিভ attempt_completion কল করে উত্তর দিয়েছে: ফাংশনটি যোগ করার পরিবর্তে বিয়োগ করে। পরীক্ষার দ্বিতীয় অংশ হল গেটওয়ে প্যানেল: "Usage" বিভাগে প্রতিটি মডেল অনুযায়ী অনুরোধটি প্রদর্শিত হবে এবং কী-এর সর্বশেষ ব্যবহারের সময় আপডেট হবে।

Auto-Approve ছাড়া, ভুলটি API Request Failed ব্লকের মাধ্যমে Retry এবং Start New Task বোতাম সহ আসে, সাথে কোড এবং পুনরায় চেষ্টার কাউন্টডাউন সহ Provider Error হেডার থাকে। গেটওয়ের উত্তরের টেক্সট মেসেজে বা তার বিস্তারিত অংশে দেখা যায়:

একটি এজেন্ট চ্যাটের চেয়ে ভিন্নভাবে টোকেন খরচ করে। Zoo Code প্রতিটি রিকোয়েস্টে মোডের নিয়ম, টুলের বর্ণনা এবং ওয়ার্কিং ফোল্ডারের তথ্যসহ একটি সিস্টেম প্রম্পট পাঠায় — আপনার প্রশ্ন করার আগেই হাজার হাজার টোকেন খরচ হয়ে যায় — এবং একটি টাস্ক সম্পন্ন করতে সাধারণত কয়েকটি ধাপ লাগে। তাই এখানে প্রতি টোকেনের দাম গুরুত্বপূর্ণ।

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

তুলনার জন্য — Zoo Code-এ মডেলের জন্য যেভাবে পেমেন্ট করা যায়:

ইনপুট এবং আউটপুট প্রাইস সেট থাকলে টাস্কের হেডারেই খরচ দেখা যায়, তবে সেন্টের হিসাব অনুযায়ী — নেটওয়ার্ক মডেলের ছোট কাজগুলোতে $0.00 দেখাতে পারে। সঠিক খরচ এবং ব্যালেন্স দেখতে ড্যাশবোর্ডের «Usage» এবং «Billing» সেকশন দেখুন।

অনুমোদন এবং স্বায়ত্তশাসন। ডিফল্টভাবে, Auto-Approve বন্ধ থাকে এবং Zoo Code পড়ার, লেখার এবং কমান্ডের অনুমতির জন্য জিজ্ঞাসা করে; দীর্ঘ কাজের জন্য ইনপুট ফিল্ডের পাশে Auto-approve মেনুতে প্রয়োজনীয় বিভাগগুলো চালু করুন। কমান্ডের জন্য Destructive Command Guard (Settings → Auto-Approve) আছে: এক্সটেনশনটি এর এক্সিকিউটেবল ফাইল ডাউনলোড করে এবং এর দ্বারা অনুমোদিত কমান্ডগুলো নিজে থেকেই কার্যকর হয়, আর ব্লক করা কমান্ডগুলো অনুমোদনের অপেক্ষায় থাকে। Auto-Approve সহ, Zoo Code ব্যর্থ অনুরোধগুলোও নিজে পুনরায় চেষ্টা করে: বিরতি ৫ সেকেন্ড থেকে শুরু হয় এবং প্রতিটি চেষ্টার সাথে দ্বিগুণ হয়, তবে ১০ মিনিটের বেশি হয় না।

স্ট্রিমিং রেসপন্স। Enable streaming বন্ধ করবেন না: স্ট্রিমে গেটওয়ে টেক্সট জেনারেশনের সাথে সাথে প্রদান করে এবং রেসপন্স শুধুমাত্র মডেলের সীমাবদ্ধতার দ্বারা নিয়ন্ত্রিত হয়, কিন্তু স্ট্রিমিং ছাড়া এবং স্পষ্ট সীমা ছাড়া অনুরোধগুলো ১৫০০ টোকেন রেসপন্সে ট্রাঙ্কেট করে (GLM-5.3 Flash-এর ক্ষেত্রে ৩০০০)।

কোড ইনডেক্সিং। প্রজেক্টে সেমান্টিক সার্চ (Codebase Indexing) মডেল থেকে আলাদাভাবে এমবেডিং প্রোভাইডারের মাধ্যমে কনফিগার করা হয়; এর জন্য একটি লোকাল বিকল্প Semble - Local আছে।

ছবি। নেটওয়ার্কের মডেলগুলো টেক্সট-ভিত্তিক। স্ক্রিনশট এবং মকআপের জন্য, ইমেজ নিয়ে কাজ করতে পারে এমন মডেলের সাথে একটি আলাদা প্রোফাইল তৈরি করুন এবং এমন কাজের জন্য সেখানে সুইচ করুন।

গোপনীয়তা। Zoo Code ডেভেলপারদের কাছে ইন্সটলেশন আইডির সাথে যুক্ত এরর এবং ব্যবহারের তথ্য পাঠায় - কোড বা প্রম্পট ছাড়া; এটি Settings → About Zoo Code-এ Allow error and usage reporting সুইচ দিয়ে বন্ধ করা যায়। গেটওয়ে প্রম্পট বা রেসপন্সের বিষয়বস্তু সংরক্ষণ করে না: ড্যাশবোর্ডে শুধুমাত্র রিকোয়েস্ট এবং টোকেন কাউন্টার দেখা যায়।