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 فائل (Windows پر — %USERPROFILE%\.factory\settings.json) کے customModels ایرے میں نیٹ ورک کے ہر ماڈل کے لیے ایک اندراج لکھے گا: گیٹ وے کا پتہ، پرووائیڈر کی قسم 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 سسٹم پرامپٹ، ٹولز کی تفصیلات اور ورکنگ ڈائرکٹری کا اسکرین شاٹ شامل کرتا ہے، اور ایک ٹاسک مکمل ہونے میں کئی سٹیپس لگتے ہیں۔ ہمارے ٹیسٹ کے دوران، آپ کے سوال سے پہلے ہی ہر سٹیپ میں تقریباً 9.5 ہزار ان پٹ ٹوکن خرچ ہوئے: «فائل پڑھنا اور غلطی تلاش کرنا» ٹاسک میں دو سٹیپس اور تقریباً 19 ہزار ٹوکن لگے، جبکہ «درست کرنا اور تصدیق کرنا» میں چار سٹیپس اور تقریباً 44 ہزار ٹوکن خرچ ہوئے۔ اس لیے یہاں فی ٹوکن قیمت بہت اہمیت رکھتی ہے۔

JoinGonka Gateway کے ذریعے ٹوکن کی قیمت ان پٹ کے لیے $0.0069 فی ملین اور آؤٹ پٹ کے لیے $0.021 فی ملین ہے — یہ قیمت نیٹ ورک کے تمام ماڈلز کے لیے یکساں ہے اور اس صفحے پر لائیو سورس سے لی گئی ہے۔

دائیں کالم میں دی گئی قیمتیں ستمبر 2026 کے مطابق ہیں۔ موازنہ کے لیے — Droid میں ماڈلز کے لیے ادائیگی کے طریقے:

Droid انٹرفیس میں /cost کمانڈ سیشن کے اعدادوشمار دکھاتی ہے، اور BYOK ماڈلز کے لیے درست خرچ اور بیلنس گیٹ وے ڈیش بورڈ کے «Usage» اور «Billing» سیکشنز میں دیکھا جا سکتا ہے۔ Droid کے لیے ایک الگ کی (Key) بنائیں — اس کا ٹریفک ایک الگ لائن میں نظر آئے گا۔

خودمختاری۔ ون شاٹ موڈ میں 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 فلیگ کے ساتھ۔