Factory Droid + JoinGonka Gateway: Gonka নেটওয়ার্ক মডেলে BYOK

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

# macOS and Linux
curl -fsSL https://app.factory.ai/cli | sh

# Homebrew
brew install --cask droid

# Windows (PowerShell)
irm https://app.factory.ai/cli/windows | iex

# via npm
npm install -g droid

স্ক্রিপ্টটি বাইনারিটিকে ~/.local/bin-এ রাখে এবং সেই ডিরেক্টরিটি PATH-এ কীভাবে যোগ করবেন তা জানায়; Linux-এ ডকুমেন্টেশন অনুযায়ী অতিরিক্ত xdg-utils প্যাকেজও ইনস্টল করতে হবে। যাচাই করুন — droid --version।

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

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

npx @joingonka/setup --tool droid

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

• ~/.factory/settings.json ফাইলের customModels অ্যারেতে (Windows-এ — %USERPROFILE%\.factory\settings.json) নেটওয়ার্কের প্রতিটি মডেলের জন্য একটি এন্ট্রি লিখবে: গেটওয়ের ঠিকানা, প্রোভাইডার টাইপ generic-chat-completion-api, কী সরাসরি লেখা, প্রকৃত কনটেক্সট উইন্ডো এবং উত্তরের সীমা; ফাইলটি 600 পারমিশন পাবে;
• ডিফল্ট মডেল — sessionDefaultSettings.model — DeepSeek V4 Flash-এ সেট করবে, তবে কেবল তখনই যদি মডেলটি নির্বাচিত না থাকে বা নেটওয়ার্ক থেকে সরে যাওয়া কোনো মডেলের দিকে ইশারা করে। Factory-এর ক্যাটালগের মডেল বা অন্য কারও BYOK এন্ট্রি এটি ওভাররাইড করে না, বরং কীভাবে সুইচ করবেন তা জানায়;
• আগের ফাইলের একটি কপি সংরক্ষণ করবে, এবং customModels-এ অন্য কারও এন্ট্রি, বাকি সেটিংস ও কমেন্ট অপরিবর্তিত রাখবে; যে ফাইল পার্স করা যায় না তা পুনর্লিখন করবে না, বরং কী ঠিক করতে হবে তা বলবে;
• শেষে গেটওয়েতে একটি লাইভ রিকোয়েস্ট পাঠাবে এবং কী, ঠিকানা ও মডেল গৃহীত হয়েছে কিনা তা সরাসরি জানাবে।

--model ফ্ল্যাগ deepseek, glm বা minimax সংক্ষেপণসহ অন্য ডিফল্ট মডেল নির্ধারণ করে — স্পষ্টভাবে উল্লেখ করা মডেল সর্বদা লেখা হয়। ডটফাইল ও সার্ভারের জন্য প্রশ্নহীন মোড রয়েছে, সেখানে কী পরিবেশ ভেরিয়েবল থেকে নেওয়া হয়:

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

Droid পুনরায় চালু করার প্রয়োজন নেই: settings.json-এর পরিবর্তন এটি নিজেই লক্ষ্য করে। শেষে 429 রেসপন্সসহ ! Could not verify right now লাইনটির অর্থ মডেলটি ব্যস্ত, কনফিগারেশনে ত্রুটি নয় — কনফিগারেশন ইতিমধ্যে লেখা হয়ে গেছে।

ইনস্টলার যা করে, তার সবকিছুই হাতে লেখা সম্ভব। Droid-এর ব্যবহারকারী সেটিংস ~/.factory/settings.json-এ সংরক্ষিত থাকে; ফাইল না থাকলে Droid প্রথম চালুর সময় তা তৈরি করে। Gonka নেটওয়ার্কের জন্য দরকার customModels অ্যারে এবং একটি ডিফল্ট মডেল:

{
  "customModels": [
    {
      "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
      "id": "custom:deepseek-ai/DeepSeek-V4-Flash-0731",
      "displayName": "DeepSeek V4 Flash (Gonka)",
      "baseUrl": "https://gate.joingonka.ai/v1",
      "apiKey": "jg-your-key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 32768,
      "maxContextLimit": 380000,
      "noImageSupport": true
    },
    {
      "model": "zai-org/GLM-5.3-Flash",
      "id": "custom:zai-org/GLM-5.3-Flash",
      "displayName": "GLM 5.3 Flash (Gonka)",
      "baseUrl": "https://gate.joingonka.ai/v1",
      "apiKey": "jg-your-key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 8192,
      "maxContextLimit": 390000,
      "noImageSupport": true
    },
    {
      "model": "MiniMaxAI/MiniMax-M2.7",
      "id": "custom:MiniMaxAI/MiniMax-M2.7",
      "displayName": "MiniMax M2.7 (Gonka)",
      "baseUrl": "https://gate.joingonka.ai/v1",
      "apiKey": "jg-your-key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 8192,
      "maxContextLimit": 200000,
      "noImageSupport": true
    }
  ],
  "sessionDefaultSettings": {
    "model": "custom:deepseek-ai/DeepSeek-V4-Flash-0731"
  }
}

ডিফল্ট মডেল sessionDefaultSettings.model-এ থাকে এবং এন্ট্রিকে তার id দিয়ে রেফারেন্স করে। Factory ডকুমেন্টেশনে ফাইলের রুটে আরেকটি model কী-এর কথা আছে, কিন্তু আমাদের পরীক্ষায় -m ফ্ল্যাগ ছাড়া droid exec মডেল নিয়েছিল sessionDefaultSettings থেকেই — মান বদলানোর পরেও তাই।

কী-টি ফাইলে সাদা টেক্সটে থাকে: chmod 600 ~/.factory/settings.json কমান্ড দিয়ে ফাইলটি বন্ধ করুন এবং কী-যুক্ত এন্ট্রি প্রজেক্টের .factory/settings.json-এ কখনো রাখবেন না — সেটি সাধারণত রিপোজিটরিতে চলে যায়। আর Droid চালুর পর ফাইলটি অন্যভাবে দেখা গেলে সেটাই স্বাভাবিক: যেকোনো সেটিংস সংরক্ষণের সময় Droid পুরো ফাইলটি নতুন করে লেখে — কীগুলো সাজায়, এন্ট্রিতে index ফিল্ড যোগ করে এবং মন্তব্য সংরক্ষণ করে না। তখনও 600 পারমিশন অপরিবর্তিত থাকে, আর ইনস্টলার এমন এন্ট্রি নির্দ্বিধায় আপডেট করে।

Droid তার নিজস্ব রেকর্ডিংগুলিকে ক্যাটালগ থেকে আলাদাভাবে দেখায়: ডকুমেন্টেশন অনুযায়ী, ইন্টারঅ্যাকটিভ মোডে /model কমান্ড সেগুলিকে Custom models বিভাগে দেখায়, আর Ctrl+N সরাসরি ইনপুট ফিল্ডেই মডেলগুলির মধ্যে ঘুরে বেড়ায়। ওয়ান-শট মোডে মডেল নির্ধারণ করে -m ফ্ল্যাগ, যার মান আসে id ফিল্ড থেকে, স্ল্যাশগুলি যেমন আছে তেমনই লেখা হয়: droid exec -m custom:zai-org/GLM-5.3-Flash "…"।

নাম ভুল হলে Droid Invalid model জানাবে এবং সে যেসব মডেল দেখতে পায় তার সবগুলি তালিকা করবে, নিজেরগুলিসহ custom:… (display name) আকারে: তখনই বোঝা যায় রেকর্ডিংগুলি লোড হয়েছে। Factory-র ডকুমেন্টেশন স্টাইলের নাম, অর্থাৎ সাবস্ক্রিপ্ট ও নম্বর দিয়ে গঠিত নাম (custom:DeepSeek-V4-Flash-(Gonka)-0), স্পষ্ট id থাকলে কাজ করবে না — আমাদের রানে এটি একই Invalid model দিয়েছিল।

Factory অ্যাকাউন্ট কী কী চায়। নিজস্ব মডেল টোকেনের পেমেন্টের প্রশ্ন সরিয়ে দেয়, কিন্তু পণ্যটিতে প্রবেশের প্রশ্ন নয়। অ্যাকাউন্টে লগইন না করে Droid 0.225.1-এর রানে যা দেখা গেল:

ইন্টারফেসে কাজ করতে Factory অ্যাকাউন্ট খুলে ব্রাউজার দিয়ে লগইন করুন — Login আইটেম বা /login কমান্ড; ব্রাউজার ছাড়া মেশিনে ডকুমেন্টেশন অ্যাকাউন্ট সেটিংস থেকে কি FACTORY_API_KEY ভেরিয়েবলে দেওয়ার পরামর্শ দেয়। লগইন ছাড়া droid exec-এর কাজ পরখ করার জন্য সুবিধাজনক, কিন্তু সরকারিভাবে বর্ণিত নয় — CI-তে এর উপর ভরসা করবেন না। Factory-র মূল্য পৃষ্ঠা অনুযায়ী, BYOK সমস্ত ব্যক্তিগত প্ল্যানে বিনামূল্যের লিমিটসহ অন্তর্ভুক্ত, আর লিমিটের বেশি হলে BYOK ব্যবহার প্ল্যানের শর্ত অনুযায়ী বিল হয়; হালনাগাদ শর্ত — factory.ai/pricing-এ। নেটওয়ার্কের মডেলগুলির টোকেন অবশ্য আলাদাভাবে পরিশোধিত হয় — JoinGonka-র ব্যালান্স থেকে।

কোন মডেল বেছে নেবেন। নেটওয়ার্কের সব মডেলের দাম একই, তাই পছন্দটা আসলে আচরণের প্রশ্ন। আমাদের droid exec রানে একটি কাজ — ফাইল পড়ে ত্রুটি খুঁজে বের করা — কীভাবে তারা করল:

-r ফ্ল্যাগ (রিজনিং লেভেল) Factory-র ডকুমেন্টেশন অনুযায়ী BYOK মডেলে প্রযোজ্য নয়। ডিফল্টে কেন DeepSeek V4 Flash বেছে নেওয়া হয়েছে, তা বিশ্লেষণ করা হয়েছে মডেল পর্যালোচনায়।

একটি খালি ডিরেক্টরিতে স্পষ্ট ত্রুটি সহ calc.py ফাইলটি রাখুন — যেমন একটি আয়তক্ষেত্রের ক্ষেত্রফল, যেখানে বাহুগুলো গুণের বদলে যোগ করা হয়েছে — এবং Droid-কে এটি খুঁজে বের করতে বলুন:

droid exec "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

ফ্ল্যাগ ছাড়া droid exec শুধুমাত্র পড়ার মোডে কাজ করে: ফাইল দেখা যায়, পরিবর্তন করা যায় না। এজেন্ট নিজেই পড়ার টুলটি কল করবে এবং ত্রুটিপূর্ণ এক্সপ্রেশন উল্লেখ করে সারমর্মে উত্তর দেবে। -o json ফ্ল্যাগের সাথে উত্তরটি একটি অবজেক্ট হিসেবে আসে, যা স্ক্রিপ্ট দিয়ে পার্স করা সুবিধাজনক (আউটপুট সংক্ষিপ্ত):

{"type":"result","subtype":"success","is_error":false,"duration_ms":2239,"num_turns":2,
 "result":"Yes, the file has a bug: the rectangle area is computed as the sum of the side lengths, but it should be their product (width * height). …",
 "usage":{"input_tokens":19016,"output_tokens":146,"factory_credits":0,"ttft_ms":747}}

factory_credits: 0 ক্ষেত্রটি নিশ্চিত করে যে কাজটি আপনার মডেলে হয়েছে, Factory ক্রেডিটে নয়। এজেন্ট যাতে ফাইল সম্পাদনা করতে পারে, সেজন্য স্বায়ত্তশাসনের স্তর যোগ করুন: droid exec --auto low "Fix the bug in calc.py and change nothing else." — আমাদের রানে DeepSeek V4 Flash ফাইলটি পড়েছে, যোগকে গুণ দিয়ে প্রতিস্থাপন করেছে এবং 12 আউটপুট হচ্ছে কিনা তা যাচাই করতে নিজেই স্ক্রিপ্টটি চালিয়েছে।

তৃতীয় যাচাই — গেটওয়ের দিক থেকে: ড্যাশবোর্ডের «ব্যবহার» বিভাগে অনুরোধটি «মডেল অনুযায়ী» ব্রেকডাউনে দেখা যাবে, এবং «কী অনুযায়ী» ব্লকে শেষ অনুরোধের সময় আপডেট হবে।

যদি কিছু ভুল হয়ে যায়, তাহলে Droid-এর একটি বিশেষত্ব মনে রাখবেন: কনসোলে droid exec শুধুমাত্র Error during droid execution: Exec failed প্রিন্ট করে (JSON-এ — "result":"Exec failed"), কিন্তু আসল কারণটি লগে থেকে যায়। একটি কমান্ডে এটি বের করা যায়:

grep agent_error_count ~/.factory/logs/droid-log-single.log | grep -o '"errorMessage":"[^,]*' | tail -1

এজেন্ট টুল চ্যাট থেকে ভিন্নভাবে টোকেন খরচ করে: প্রতিটি বাক্যে Droid সিস্টেম প্রম্পট, টুলের বর্ণনা এবং ওয়ার্কিং ডিরেক্টরির স্ন্যাপশট যোগ করে, আর একটি টাস্ক সম্পন্ন করতে কয়েক ধাপ সময় লাগে। আমাদের রানে, আপনার প্রশ্ন করার আগেই প্রতিটি ধাপে প্রায় ৯.৫ হাজার ইনপুট টোকেন খরচ হয়: «ফাইল পড়া এবং ত্রুটি খোঁজা» টাস্কে দুই ধাপ এবং প্রায় ১৯ হাজার টোকেন খরচ হয়েছে, আর «সংশোধন এবং যাচাই»-এ চার ধাপ এবং প্রায় ৪৪ হাজার টোকেন লেগেছে। তাই এখানে প্রতি টোকেনের দাম গুরুত্বপূর্ণ।

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

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

Droid ইন্টারফেসে /cost কমান্ড সেশনের পরিসংখ্যান দেখায়, আর BYOK মডেলের জন্য সঠিক খরচ এবং ব্যালেন্স গেটওয়ে ড্যাশবোর্ডের «ব্যবহার» (Usage) এবং «বিলিং» (Billing) বিভাগে দেখা যায়। Droid-এর জন্য একটি আলাদা কী ব্যবহার করুন — এর ট্র্যাফিক একটি আলাদা লাইনে দেখা যাবে।

স্বায়ত্তশাসন। ওয়ান-শট মোডে Droid ডিফল্টভাবে শুধু পড়ে, স্তরগুলো অনুমতি বাড়ায়: --auto low — ফাইল সম্পাদনা, --auto medium — এর সাথে ডিপেন্ডেন্সি ইনস্টলেশন, বিল্ড, টেস্ট এবং লোকাল কমিট, --auto high — push এবং ডিপ্লয় পর্যন্ত। --skip-permissions-unsafe ফ্ল্যাগ সব চেক সরিয়ে দেয় — শুধুমাত্র ওয়ান-টাইম কন্টেইনারের জন্য। ইন্টার্যাক্টিভ মোডে স্তর পরিবর্তন করে Ctrl+L, এবং শুরুর স্তর সেট করে sessionDefaultSettings.autonomyLevel; সেখানে ডিফল্ট off — সবকিছু নিশ্চিতকরণসহ।

কমিটে স্বাক্ষর। includeCoAuthoredByDroid সেটিং ডিফল্টভাবে চালু: Droid কমিট বার্তায় সহ-লেখকের একটি লাইন যোগ করে। যদি এটি প্রয়োজন না হয়, settings.json-এ "includeCoAuthoredByDroid": false লিখুন।

সেশন কোথায় সংরক্ষিত হয়। অ্যাকাউন্টে সাইন ইন করার পর Droid ডিফল্টভাবে CLI সেশনগুলো Factory-এর ওয়েব সংস্করণে মিরর করে — এর জন্য দায়ী cloudSessionSync। BYOK কী, ডকুমেন্টেশন অনুযায়ী, লোকাল থাকে; যদি কথোপকথনও মেশিনে থাকা উচিত হয়, "cloudSessionSync": false সেট করুন। গেটওয়ে তার দিক থেকে প্রম্পট এবং উত্তরের বিষয়বস্তু সংরক্ষণ করে না — পরিসংখ্যানে শুধু খরচের সমষ্টি থাকে।

আপডেট। স্ক্রিপ্ট দিয়ে ইনস্টলেশন নিজেই আপডেট হয়; FACTORY_DROID_AUTO_UPDATE_ENABLED=false ভেরিয়েবল বা droid update --version <version> কমান্ড দিয়ে সংস্করণ লক করা যায়; npm থেকে বিল্ডগুলো নিজে থেকে আপডেট হয় না। আপডেটের পর একটি droid exec দিয়ে যাচাই করুন যে নেটওয়ার্কের মডেলগুলো জায়গায় আছে।

ছবি। নেটওয়ার্কের মডেলগুলো টেক্সট-ভিত্তিক; স্ক্রিনশটের জন্য অন্য প্রোভাইডারের ভিশন-সক্ষম মডেলের একটি এন্ট্রি পাশে রাখুন।

যদি ভেন্ডর অ্যাকাউন্ট ছাড়া কাজ করা অপরিহার্য হয়। নেটওয়ার্কের একই মডেলগুলো খোলা টার্মিনাল এজেন্টে সংযুক্ত করা যায়, যেগুলোর সাইন-ইন লাগে না — যেমন OpenCode-এ একই ইনস্টলারের সাথে, --tool opencode ফ্ল্যাগ দিয়ে।