ایک سستے ماڈل پر dsh-superagent چلائیں: GitHub issue سے PR تک

آپ ایک نئے GitHub issue میں کسی ایجنٹ کا ذکر کرتے ہیں، چائے بنانے جاتے ہیں، اور واپس آ کر ایک pull request دیکھتے ہیں۔ DeepSeek کا dsh-superagent یہی کرتا ہے، اور آپ اسے DeepSeek Harness (DSH) کے ذریعے CheapTokens کے ماڈل پر چلا سکتے ہیں۔ نیچے: انسٹال، ایجنٹ کا اپنا GitHub اکاؤنٹ، پہلا ٹیسٹ issue، اور ایک ٹکٹ کا بجٹ۔

خود ریپوزٹری کی طرف سے ایک انتباہ۔ اس کا README (2 نومبر 2026 کو چیک کیا گیا) اسے صرف حوالے کے لیے ایک ریسرچ پروٹوٹائپ کہتا ہے، نہ کہ کوئی سرکاری DeepSeek پروڈکٹ، اور کہتا ہے کہ اس میں اب بھی bugs ہو سکتے ہیں۔ یہ MIT لائسنس یافتہ ہے، main پر اس کا ایک commit ہے اور کوئی release نہیں۔ اسے ایسی ریپوزٹری پر چلائیں جس پر تجربہ کرنا آپ کے لیے قابلِ برداشت ہو۔

یہ اصل میں کیا کرتا ہے#

dsh-superagent ایک GitHub ریپوزٹری کے لیے ایک proactive coding agent ہے، جو DeepSeek Harness کے لیے bundle کے طور پر پیک کیا گیا ہے۔ یہ GitHub کو سنتا ہے۔ جب آپ کی allow-list میں شامل کوئی شخص درخواست کرتا ہے، تو یہ ایک work item کھولتا ہے (docs اسے Ticket کہتے ہیں)، اپنے agent session اور اپنی directory میں کام کرتا ہے، اور اصل گفتگو میں جواب دیتا ہے، مثلاً ایک pull request کے ساتھ۔ ایک web panel ان items کو دکھاتا ہے جنہیں کسی شخص کی ضرورت ہو۔

تو ایک issue ایک session ہے، اور ایک session model calls کا ایک loop ہے۔ tokens اسی loop میں جاتے ہیں؛ اگر آپ نے نہیں دیکھا کہ ایسا کیوں ہے، تو why AI agents use so many tokens ایک 20-مرحلہ مثال کے ذریعے سمجھاتا ہے۔

شروع کرنے سے پہلے#

deployment doc کے مطابق آپ کو درکار ہے:

• Node.js 22.19+ یا 24+، pnpm، git 2.32+، tmux، Python 3.8+
• GitHub CLI 2.48+ (ایک چھوٹے wrapper کے ذریعے استعمال ہوتا ہے، نیچے دیکھیں)
• github.com پر ایک ریپوزٹری (GitHub Enterprise Server معاون نہیں ہے)
• ریپو کے package.json میں engines.dsh سے لے کر اس version range میں DSH
• ایک DSH model provider

آخری چیز وہ ہے جو ریپوزٹری آپ پر چھوڑ دیتی ہے: setup guide provider کو operator step کہتا ہے۔ CheapTokens کے لیے، پہلے connect DeepSeek Harness to CheapTokens کریں اور واپس آئیں۔ استعمال کرنے کے لیے model id deepseek-ai/DeepSeek-V4-Flash-0731 ہے (مکمل id، price tables والا مختصر نام API قبول نہیں کرتا)، اور API base https://api.cheaptokens.dev/v1 ہے۔ تفصیلات CheapTokens docs page پر ہیں۔

ایک چیز کا خیال رکھیں۔ deployment doc کے مطابق، setup ان environment variables کو ہٹا دیتا ہے جن کے ناموں میں KEY، PASSWORD، SECRET یا TOKEN ہو، اور worker environment سے GH_TOKEN اور GITHUB_TOKEN کو حذف کر دیتا ہے۔ تو shell میں export کیا گیا provider key worker تک نہیں پہنچے گا؛ اسے connect مضمون میں بتائے گئے طریقے سے سیٹ کریں۔

انسٹال اور شروع کریں#

npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype dsh-superagent
cd dsh-superagent
pnpm install && pnpm build

dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

scripts/dsh-superagent start
scripts/dsh-superagent status

status command exit code کے ساتھ جواب دیتا ہے: 0 نارمل ہے، 1 کا مطلب ہے کہ restart مدد کر سکتا ہے، 2 کا مطلب ہے کہ کوئی حصہ ناکام ہوا اور restart اسے ٹھیک نہیں کرے گا، 3 کا مطلب ہے کہ setup اب بھی درکار ہے۔ defaults سے شروع کریں: profile superagent، branch prefix agent/، اور accept mode observe، جو proactive کام کو کیے بغیر ریکارڈ کرتا ہے۔

ایجنٹ کو اس کا اپنا GitHub اکاؤنٹ دیں#

یہی وہ مرحلہ ہے جسے لوگ چھوڑ دیتے ہیں اور پھر حیران ہوتے ہیں کہ کچھ کیوں نہیں ہوتا۔ ایجنٹ کو ایک عام GitHub user درکار ہے جس کے پاس آپ کی ریپوزٹری تک write access ہو؛ GitHub App اس کردار میں نہیں آ سکتا۔

1. user بنائیں اور اسے write access کے ساتھ collaborator کے طور پر شامل کریں۔
2. ایک wrapper ~/.local/bin/gh-agent بنائیں: GH_CONFIG_DIR="$HOME/.config/gh-agent" exec gh "$@"۔ یہ ایجنٹ کے login کو آپ کے اپنے gh سے الگ رکھتا ہے۔
3. gh-agent auth login کو اسی user کے طور پر چلائیں۔
4. web panel میں، Sources کھولیں، ریپوزٹری (owner/name) اور CLI path کو wrapper پر سیٹ کریں۔
5. Policy کے تحت، وہ logins شامل کریں جو ایجنٹ کو کام دے سکتے ہیں policy.sources.github.allowed میں۔ جب تک کوئی اس فہرست میں نہ ہو، کچھ بھی Ticket نہیں بنتا۔

آپ کا پہلا ٹیسٹ issue#

ریپوزٹری میں ایک نیا issue کھولیں اور کچھ چھوٹا اور غیر مبہم لکھیں، ایجنٹ کے login کے ساتھ code format میں، مثلاً: @<agent login> fix the typo in README.md: "recieve" should be "receive"۔

لفظ "نیا" اہم ہے۔ ذکر شامل کرنے کے لیے کسی پرانے issue میں ترمیم کو نہیں پکڑا جاتا؛ نیا issue یا نیا comment پکڑا جاتا ہے۔ اگر panel ایک Ticket دکھائے اور پھر agent/ سے شروع ہونے والی branch ظاہر ہو، تو chain کام کر رہی ہے۔

ایک ٹکٹ کی لاگت#

ریپوزٹری فی ٹکٹ token usage شائع نہیں کرتی، تو یہ بیان کردہ مفروضوں پر مبنی ایک اندازہ ہے۔ فرض کریں ایک چھوٹا ٹکٹ 25 model calls لیتا ہے۔ ہر call بڑھتی ہوئی گفتگو اٹھاتی ہے: اوسطاً تقریباً 30,000 tokens input، اور تقریباً 800 tokens جواب (ایک command، ایک patch، ایک مختصر نوٹ)۔

فی ٹکٹ یہ 30,000 × 25 = 750,000 input tokens اور 800 × 25 = 20,000 output tokens ہے۔ آج کی CheapTokens قیمتوں پر DeepSeek-V4-Flash پر (input $0.015 اور output $0.10 فی 1M tokens)، ایسا ایک ٹکٹ $0.0133 ہے۔

غیر متوازن حصہ: input output سے تقریباً 37 گنا ہے، اور یہ ایجنٹس کے لیے نارمل ہے، کیونکہ ہر مرحلہ پچھلا سب کچھ دوبارہ بھیجتا ہے۔ دوسرے ماڈلز پر وہی ٹکٹ:

جدول GLM-5.3-Flash (390K context، فی جواب 8,192 output tokens تک) بھی درج کرتا ہے اگر آپ کے ٹکٹ چھوٹے ہیں اور جوابات مختصر ہیں۔ طویل tool loops کے لیے، DeepSeek-V4-Flash آپ کو 380K context، فی جواب 32,768 tokens تک اور کسی بھی وقت ایک ہی قیمت دیتا ہے۔ آپ کے اپنے اعداد مختلف ہوں گے، تو sliders کو حرکت دیں:

اگر آپ input کی طرف کم کرنا چاہتے ہیں، تو how to estimate the cost of an AI agent ان عادات کا احاطہ کرتا ہے جو سب سے زیادہ اہم ہیں۔

اسے مختصر رسے پر رکھیں#

ایک دن observe mode پر رہیں: یہ ریکارڈ کرتا ہے کہ ایجنٹ اپنے طور پر کیا کرے گا، تاکہ آپ عمل کرنے سے پہلے pattern دیکھ لیں۔ پہلے صرف اپنے login کی اجازت دیں۔ پہلی تین pull requests لائن بہ لائن دیکھیں، اور پہلے دن کے بعد اپنے balance پر model usage چیک کریں، پھر اپنے حقیقی ٹکٹ کی تعداد سے ضرب دیں۔

ریپو یہ بھی کہتا ہے کہ DeepSeek کے ساتھ والے مضمون کے کچھ ڈیزائن ابھی نافذ نہیں ہوئے، تو غائب features کو نامکمل سمجھیں، اپنی غلطی نہیں۔

ذرائع#

ریپوزٹری کے تمام حقائق deepseek-ai/dsh-superagent-prototype (README، SETUP.md، docs/006-deployment.md) سے ہیں، 2 نومبر 2026 کو چیک کیے گئے۔ ریپوزٹری صفحہ کوئی commit تاریخ نہیں دکھاتا اور DSH version 0.2.1-rc.3 ایک release candidate ہے، تو انسٹال کرنے سے پہلے doc دوبارہ چیک کریں۔