Cherry Studio + JoinGonka Gateway — ڈیسک ٹاپ AI کلائنٹ

انسٹالیشن۔ تمام سسٹمز کے بلڈز پروجیکٹ کے ریلیز پیج پر موجود ہیں: Windows کے لیے انسٹالر اور پورٹیبل بلڈ، macOS کے لیے dmg امیج، Linux کے لیے AppImage، deb اور rpm—x64 اور ARM دونوں کے لیے۔ چیٹ کی تاریخ اور سیٹنگز مقامی طور پر، آپ کی مشین پر محفوظ رہتی ہیں۔

V1 یا V2۔ اگست 2026 میں نئی ڈیٹا ساخت اور دوبارہ ترتیب دی گئی سیٹنگز کے ساتھ V2 لائن آئی؛ پچھلی لائن کا آخری بلڈ 1.9.13 ہے۔ اپنا پرووائیڈر دونوں میں موجود ہے، مگر شامل کرنے کا طریقہ اور کچھ لیبل مختلف ہیں—نیچے ایسی جگہیں نشان زد ہیں۔ V1 سے اپ گریڈ کرنے پر پرووائیڈر اور ماڈل کی سیٹنگز خودکار طور پر منتقل ہو جاتی ہیں، V1 کا اصل ڈیٹا محفوظ رہتا ہے، لیکن نیا ڈیٹا واپس سنک نہیں ہوتا، اور دونوں لائنوں کے بیک اپ باہم ناہم آہنگ ہوتے ہیں۔ اپ گریڈ سے پہلے Cherry Studio ڈاکیومینٹیشن میں مائیگریشن کا حصہ پڑھ لیں۔

JoinGonka کی۔ گیٹ وے پر رجسٹر کریں، ڈیش بورڈ میں «API کیز» کا سیکشن کھولیں اور «کی بنائیں» دبائیں۔ کی jg- سے شروع ہوتی ہے اور صرف ایک بار دکھائی جاتی ہے—فوراً محفوظ کر لیں۔ Cherry Studio کے لیے الگ کی بنانا سہولت بخش ہے: «استعمال» کے سیکشن میں اس کا خرچ الگ لائن میں نظر آئے گا۔

1. گیئر آئیکن پر کلک کریں — سیٹنگز کھل جائیں گی۔ Model Provider سیکشن منتخب کریں (انگریزی دستاویزات میں اسے Model Services کہا گیا ہے)۔
2. پرووائیڈرز کی فہرست کے نیچے Add Provider پر کلک کریں۔
3. V2 میں Add Custom Provider ڈائیلاگ کھلے گا۔ Provider Name لکھیں — مثلاً JoinGonka۔ Endpoint settings بلاک میں OpenAI لائن میں https://gate.joingonka.ai/v1 ایڈریس درج کریں: فیلڈ کے نیچے Request path کی لائن نظر آئے گی جس میں حتمی راستہ ہوگا — اس کا اختتام /v1/chat/completions پر ہونا چاہیے۔ API Key فیلڈ میں jg-your-key پیسٹ کریں اور Add پر کلک کریں۔
4. V1 میں ڈائیلاگ مختصر ہے: پرووائیڈر کا نام اور Provider Type — OpenAI منتخب کریں۔ کلید اور ایڈریس پرووائیڈر کے صفحے ہی پر API Key اور API Host فیلڈز میں درج کیے جاتے ہیں۔
5. یقینی بنائیں کہ پرووائیڈر فعال ہے: ٹوگل اس کے صفحے کے اوپری دائیں کونے میں ہوتا ہے۔ V2 میں نئے پرووائیڈرز بند حالت میں شامل ہوتے ہیں، اور بند پرووائیڈر کے ماڈلز انتخاب کی فہرستوں میں نظر نہیں آتے۔

Cherry Studio ایڈریس کیسے بناتا ہے۔ API Host فیلڈ بنیادی ایڈریس وصول کرتی ہے، اور راستہ ایپ خود شامل کرتی ہے اور فیلڈ کے نیچے Preview لائن میں نتیجہ دکھاتی ہے۔ قواعد دونوں ورژنز میں یکساں ہیں:

پرانے ہدایات میں ایک اور قاعدہ ملتا ہے: ایڈریس کے آخر میں سلیش بظاہر /v1 بند کر دیتا ہے۔ یہ ابتدائی ورژنز میں، سیریز 1.6 تک، کارآمد تھا اور 1.7 میں ہٹا دیا گیا: موجودہ بلڈز میں خودکار شمولیت صرف # بند کرتا ہے۔

پرووائیڈر شامل ہو گیا ہے، لیکن چیٹ میں ابھی نظر نہیں آ رہا: Cherry Studio کی سلیکشن لسٹ میں صرف وہ ماڈلز آتے ہیں جو آپ نے واضح طور پر شامل کیے ہیں۔ اس کے دو طریقے ہیں۔

سرور سے فہرست۔ پرووائیڈر کے صفحے پر Sync models پر کلک کریں (V1 میں — Manage، پھر Fetch model list)۔ Cherry Studio گیٹ وے سے GET /v1/models کی درخواست کرے گا اور نیٹ ورک کی موجودہ حالت دکھائے گا؛ + بٹن کے ساتھ ضروری ماڈلز شامل کریں۔ دستی طور پر۔ Add Model بٹن ایک فارم کھولتا ہے جہاں ایک فیلڈ لازمی ہے — Model ID: شناخت کنندہ کو بالکل اسی طرح ٹائپ کرنا ہوگا۔

نیٹ ورک کے ماڈلز کی قیمت ایک جیسی ہے، اس لیے سب شامل کریں — بجٹ نہیں بلکہ کام کی نوعیت کے مطابق انتخاب کرنا ہوگا:

ماڈل کی اقسام۔ فہرست میں ہر ماڈل کے ساتھ سیٹنگز کا بٹن ہے، جہاں اس کی صلاحیتیں درج ہوتی ہیں: Vision, Reasoning, Tool وغیرہ۔ Cherry Studio کچھ نشانات خود لگاتا ہے، لیکن گیٹ وے ماڈلز کے لیے انہیں چیک کرنا چاہیے۔ Vision بند ہونا چاہیے: نیٹ ورک کے ماڈلز صرف ٹیکسٹ پر مبنی ہیں۔ Tool کی ضرورت تب ہے اگر آپ MCP-ٹولز استعمال کریں — ٹیبل کے تمام ماڈلز ٹول کال کو سپورٹ کرتے ہیں۔ GLM-5.3 Flash کے لیے Reasoning موزوں ہے — یہ نیٹ ورک کا Reasoning-ماڈل ہے۔

ڈیفالٹ ماڈل۔ سیٹنگز کے Default Model سیکشن میں سروس رولز کے لیے ماڈلز کا تعین کیا جاتا ہے۔ اسسٹنٹ کے لیے بنیادی ماڈل کے طور پر DeepSeek V4 Flash سیٹ کریں۔ فوری ماڈل کے لیے، جو مکالموں کے نام تجویز کرے اور سرچ کوئریز تیار کرے، Cherry Studio کی دستاویزات ہلکے اور تیز ماڈل کے استعمال کا مشورہ دیتی ہیں (Reasoning ماڈل نہیں) — نیٹ ورک کے ماڈلز میں MiniMax M2.7 اس کردار کے لیے بہترین ہے، GLM-5.3 Flash کو یہاں سیٹ نہ کریں کیونکہ یہ ہمیشہ Reasoning کرتا ہے۔ ترجمے کے لیے پہلے دو میں سے کوئی بھی استعمال کر سکتے ہیں۔

پرووائیڈر پیج پر کی (key) کے بلاک میں ایک Model Check بٹن ہے (V1 میں کی فیلڈ کے پاس Check بٹن ہے)۔ ایک ماڈل منتخب کریں — Cherry Studio اسے ایک مختصر ٹرائل ریکویسٹ بھیجے گا اور رسپانس لٹنسی کے ساتھ نتیجہ دکھائے گا۔ اگر چیک کامیاب ہو جائے تو چیٹ میں جائیں، ماڈل سوئچر میں گیٹ وے ماڈل منتخب کریں اور کوئی بھی سوال پوچھیں۔

یہ یقینی بنانے کے لیے کہ ریکویسٹ گیٹ وے کے ذریعے جا رہی ہیں، اس کے ڈیش بورڈ میں 'Usage' سیکشن دیکھیں: 'By keys' بلاک میں Cherry Studio کی کے تحت ریکویسٹ اور آخری رسائی کا وقت نظر آئے گا، اور 'By models' بلاک میں منتخب کردہ ماڈل نظر آئے گا۔ V2 میں کلائنٹ کے اپنے اعداد و شمار موجود ہیں، جو Usage سیٹنگز میں ملیں گے: پرووائیڈر، ماڈل اور کی کے مطابق ٹوکن اور ریکویسٹ کا حساب۔ وہاں کی قیمت صرف ایک حوالہ ہے — Cherry Studio ماڈلز کی عوامی قیمتوں کے مطابق تخمینہ لگاتا ہے، Gonka نیٹ ورک کی قیمت کے مطابق نہیں، لہذا درست اخراجات کے لیے گیٹ وے ڈیش بورڈ دیکھیں۔

اگر کچھ غلط ہو جائے تو اس کی وجہ تقریباً ہمیشہ رسپانس سے پتہ چل جاتی ہے:

کلائنٹ مفت دستیاب ہے، آپ صرف انفرنس (inference) کے لیے ادائیگی کرتے ہیں۔ JoinGonka Gateway کے ذریعے، فی ملین ان پٹ ٹوکن کی قیمت $0.0069 اور فی ملین آؤٹ پٹ ٹوکن کی قیمت $0.021 ہے — نیٹ ورک کے تمام ماڈلز کے لیے یہ قیمت یکساں ہے اور اس صفحے پر لائیو سورس سے اپ ڈیٹ ہوتی ہے۔ چیٹ کا خرچ ایجنٹ ٹولز کے مقابلے میں کافی کم ہے، لہذا ستمبر 2026 تک اخراجات کا ایک تخمینہ نیچے دیا گیا ہے:

طویل بات چیت کے بارے میں اہم انتباہ: ہر میسج بھیجتے وقت کلائنٹ ماڈل کو پوری ہسٹری دوبارہ بھیجتا ہے، اس لیے 100 واں میسج پہلے سے مہنگا ہوتا ہے۔ حل — نئے کام کے لیے نئی چیٹ شروع کریں؛ Cherry Studio میں یہ صرف ایک بٹن کا کام ہے۔

ایک ہی ڈائیلاگ میں ماڈلز کا موازنہ۔ Cherry Studio ایک ساتھ کئی ماڈلز سے ایک ہی سوال پوچھ سکتا ہے: ماڈل سوئچر میں ان کا انتخاب کریں اور ہر ماڈل ایک الگ درخواست کے ساتھ جواب دے گا۔ نیٹ ورک کے تمام ماڈلز کے لیے یکساں قیمت کے ساتھ، یہ سمجھنے کا تیز ترین طریقہ ہے کہ آپ کے کاموں کے لیے کہاں MiniMax M2.7 کافی ہے، کہاں DeepSeek V4 Flash کا تفصیلی جواب درکار ہے، اور کہاں GLM-5.3 Flash کی منطق سودمند ہے۔ اس کی ترتیبات ماڈل ریویو میں بیان کی گئی ہیں۔

ایک ہی کلید (key) کے ساتھ دوسرا پروٹوکول۔ گیٹ وے Anthropic فارمیٹ میں بھی کام کرتا ہے۔ V2 ڈائیلاگ میں Endpoint settings بلاک میں اس کے لیے ایک الگ Anthropic لائن موجود ہے: وہاں https://gate.joingonka.ai لکھیں اور Request path لائن میں /v1/messages کا پاتھ ہونا چاہیے۔ V1 میں، Provider Type Anthropic اور اسی پتے کے ساتھ ایک الگ پرووائیڈر وہی نتیجہ دیتا ہے۔ V2 میں More options بٹن کے نیچے OpenAI Responses لائن بھی موجود ہے—گیٹ وے اسے بھی سپورٹ کرتا ہے، اس کا پتہ مرکزی OpenAI لائن جیسا ہی ہے۔

ٹرمینل ایجنٹس چلانا۔ Code CLI صفحے پر (دستاویزات میں — Coding Companion)، Cherry Studio کنسول ایجنٹس کو انسٹال اور رن کرتا ہے، اور اپنی ترتیبات سے پرووائیڈر اور ماڈل کا استعمال کرتا ہے؛ وہاں پرووائیڈرز کی فہرست اس پروٹوکول کے مطابق فلٹر کی جاتی ہے جو کسی خاص ٹول کے لیے درکار ہو۔ لہذا اگر آپ یہاں سے Claude Code چلانا چاہتے ہیں تو Anthropic کا پتہ پہلے سے بھرنا چاہیے۔ بغیر کسی ثالث کے ایجنٹ کو کیسے سیٹ اپ کریں، یہ Claude Code + Gonka گائیڈ میں بتایا گیا ہے۔

نالج بیس۔ V2 میں یہ ایمبیڈنگ ماڈل کے بغیر بھی کام کرتا ہے—BM25 ٹیکسٹ سرچ کے ذریعے، اور ایمبیڈنگ ماڈل کے ساتھ ہائبرڈ سرچ فعال ہو جاتی ہے۔ Gonka نیٹ ورک کے ماڈلز جنریٹو ہوتے ہیں، اس لیے ہائبرڈ موڈ کے لیے کسی اور پرووائیڈر کا ایمبیڈنگ ماڈل استعمال کریں، مثلاً Ollama کے ذریعے لوکل ماڈل؛ تاہم تلاش کیے گئے حصوں پر جواب گیٹ وے ماڈل دے گا۔

براؤزر میں ٹیم کے لیے مشترکہ چیٹ چاہیے؟ Cherry Studio ایک ذاتی ڈیسک ٹاپ کلائنٹ ہے۔ اکاؤنٹس کے ساتھ مشترکہ ویب انٹرفیس کے لیے Open WebUI دیکھیں: یہ اسی پتے اور کلید (key) کے ساتھ گیٹ وے سے منسلک ہوتا ہے۔