آن ڈیمانڈ ماڈل الائنمنٹ کے لیے FlashAlign انسٹال اور استعمال کرنے کا طریقہ

FlashAlign کیا ہے؟

FlashAlign، Aevonix Research کا ایک اوپن سورس نظام ہے جو معاون زبان ماڈلز پر ضرورت کے مطابق الائنمنٹ پروفائلز لاگو کرتا ہے۔ پروفائلز ہر درخواست کے لیے منتخب کیے جا سکتے ہیں یا FlashAlign کے ذریعے بھیجی جانے والی ہر درخواست پر فعال رکھے جا سکتے ہیں۔ یہ پروفائلز معاون بنیادی اور کوانٹائزڈ ویٹس کے ساتھ کام کرتے ہیں، انہیں مستقل طور پر تبدیل نہیں کرتے۔

شامل V1 ابتدائی پروفائلز انکار کم کرنے پر مرکوز ہیں۔ FlashAlign براہِ راست چل سکتا ہے، Hermes یا OpenClaw کے ساتھ مربوط ہو سکتا ہے، یا کسٹم ہارنس سے منسلک ہو سکتا ہے۔ مینیجڈ انفیرنس کے لیے Linux اور NVIDIA GPU درکار ہے۔

FlashAlign صرف ان ماڈل کالز کو تبدیل کرتا ہے جو اس کے تشکیل شدہ روٹس یا گیٹ وے URL کے ذریعے بھیجی جاتی ہیں۔ پیغامات کون بھیج سکتا ہے اور کون سے ٹولز چل سکتے ہیں، اس کا فیصلہ کرنا آپ کے ہارنس کی ذمہ داری ہے۔

اہم خصوصیات

• ضرورت کے مطابق پروفائلز: ان پروفائلز میں فی درخواست تبدیل کریں جو پہلے ہی انفیرنس انجن میں لوڈ ہو چکے ہیں۔
• قابل واپسی عمل: معاون ماڈل ویٹس کو مستقل طور پر تبدیل کیے بغیر پروفائلز لاگو کریں۔
• ایکٹیویشن کے دو طریقے: پروفائلز کو تصدیق شدہ رابطوں تک محدود کریں یا Always On موڈ کے ذریعے ہر روٹ کی جانے والی درخواست پر پروفائل لاگو کریں۔
• ٹول وراثت کے کنٹرولز: Verified contacts موڈ میں منتخب کریں کہ کون سے ٹولز فعال پروفائل کو تفویض کردہ کام تک منتقل کر سکتے ہیں۔
• ہارنس انضمامات: FlashAlign کو Hermes، OpenClaw، براہِ راست کلائنٹس یا کسٹم ہارنسز کے ساتھ استعمال کریں۔
• پیغام رسانی اڈاپٹرز: بلٹ اِن اڈاپٹرز WhatsApp اور RCS براہِ راست پیغامات کا احاطہ کرتے ہیں، جبکہ SMS اور Telegram کے لیے اختیاری معاونت موجود ہے۔
• سیٹ اپ حفاظتی اقدامات: انسٹالر مقامی ماڈلز اور ہارنسز کا پتا لگاتا ہے، مطابقت رکھنے والا پروفائل منتخب کرتا ہے، ایکٹیویشن چیک کرتا ہے، ڈپلائمنٹ سائننگ کلید بناتا ہے، اور تبدیل شدہ کنفیگریشن کا بیک اپ لیتا ہے۔
• پروفائل کا معائنہ: سیٹ اپ سے پہلے پروفائل کا ماڈل پن، آپریٹرز، سائٹس، رینکس اور ہیشز دیکھیں۔

معاون ماڈلز اور انجنز

FlashAlign 1.1.1 میں پانچ ابتدائی ماڈل پروفائلز درج ہیں، جن کے لیے درج ذیل انجن معاونت موجود ہے:

• DeepSeek V4.1 Flash 1017: vLLM یا TensorFold۔
• GLM 5.3 Full: TensorFold۔
• GLM 5.3 Flash: TensorFold یا SGLang۔
• Qwen3.8-27B: TensorFold، vLLM، SGLang یا llama.cpp۔
• Gemma 4 26B A4B: TensorFold، vLLM، SGLang یا llama.cpp۔

ریپوزٹری میں چار مختصر پروفائلز شامل ہیں۔ DeepSeek پروفائل 1.09 GB کے مقامی ٹینسر پے لوڈ کا استعمال کرتا ہے، جسے سیٹ اپ عوامی ریلیز سے ڈاؤن لوڈ کر کے چیک سم کے ذریعے تصدیق کرتا ہے۔ کسی نجی ریپوزٹری یا لاگ اِن کی ضرورت نہیں۔

تقاضے

FlashAlign انسٹال کرنے سے پہلے یقینی بنائیں کہ آپ کا ماحول متعلقہ تقاضے پورے کرتا ہے:

• NVIDIA GPU والا Linux انفیرنس ہوسٹ۔
• سیٹ اپ اور اڈاپٹرز کے لیے Python 3.10 یا بعد کا ورژن۔
• TensorFold بنڈلز استعمال کرتے وقت مطابقت رکھنے والا CPU اور GPU آرکیٹیکچر۔
• معاون ماڈل چیک پوائنٹ اور مطابقت رکھنے والا پروفائل۔
• ایسا انجن جو FlashAlign انجن کنٹریکٹ نافذ کرتا ہو۔
• OpenAI-compatible کلائنٹس کے لیے Chat Completions معاونت۔
• OpenClaw کے لیے مطابقت رکھنے والی native plugin API اور 24.x لائن میں Node 24.22.1 یا بعد کا ورژن، یا 26.x لائن میں 26.12.1 یا بعد کا ورژن۔

ہارڈویئر تقاضوں، پن کیے گئے چیک پوائنٹس، انجن کی حدود، چینلز اور تفویض کردہ کام کی معاونت کے لیے پروجیکٹ کی مطابقت گائیڈ دیکھیں۔

FlashAlign انسٹال کریں

1. معاون ماڈل ڈاؤن لوڈ کریں

خودکار سیٹ اپ چلانے سے پہلے معاون چیک پوائنٹ ڈاؤن لوڈ کریں۔ ریپوزٹری کی ماڈل ڈاؤن لوڈ گائیڈ پانچ ابتدائی پروفائلز اور ان کے معاون فارمیٹس کے لیے پن کیے گئے کمانڈز فراہم کرتی ہے۔

2. ریپوزٹری کلون کریں اور وزرڈ چلائیں

git clone https://github.com/Aevonix/FlashAlign.git
cd FlashAlign
bash ./install.sh --auto

وزرڈ مقامی ماڈلز اور معاون ہارنسز تلاش کرتا ہے، مطابقت رکھنے والا پروفائل منتخب کرتا ہے، انجن تیار کرتا ہے اور ڈپلائمنٹ سائننگ کلید بناتا ہے۔ سیٹ اپ کے دوران Verified contacts یا Always On منتخب کریں۔ اگر آپ Verified contacts منتخب کرتے ہیں تو یہ بھی طے کریں کہ آیا ٹولز کو پروفائل وراثت میں ملنا چاہیے۔

چیٹ انضمامات کنفیگریشن کے بعد منتخب گیٹ ویز کو دوبارہ شروع کرتے ہیں۔ مقامی ٹرمینل سیٹ اپ اسے لانچ کرنے کے لیے درکار کمانڈ دکھاتا ہے۔

3. ایکٹیویشن کی تصدیق کریں

سیٹ اپ ایکٹیویشن چیک کرتا ہے اور ان کنفیگریشن فائلز کا بیک اپ لیتا ہے جنہیں وہ تبدیل کرتا ہے۔ انجن کا مؤثر پروفائل ریسپانس اس بات کی تصدیق فراہم کرتا ہے کہ منتخب پروفائل فعال ہے۔

مخصوص ماڈل اور انجن کے ساتھ انسٹال کریں

جب آپ کو کسی خاص مقامی چیک پوائنٹ کا انتخاب کرنا ہو تو --model-path استعمال کریں۔ مثال کے طور پر، درج ذیل کمانڈ vLLM کے ذریعے مقامی Qwen چیک پوائنٹ کے لیے ایک اسٹینڈ الون انجن ڈپلائمنٹ بناتی ہے:

bash ./install.sh --engine-only --backend vllm --model-path /models/qwen38-27b --yes

صرف وہ امتزاج استعمال کریں جو ماڈل اور انجن کی مطابقت میٹرکس میں معاون ہوں۔ نیا ماڈل یا پروفائل لوڈ کرنا درخواست کے وقت سوئچنگ سے پہلے ہوتا ہے اور اس کے لیے انجن دوبارہ شروع کرنا پڑ سکتا ہے۔

موجودہ انجن سے منسلک ہوں

اگر مطابقت رکھنے والا انفیرنس انجن پہلے سے چل رہا ہے تو --auto کے بغیر انٹرایکٹو انسٹالر چلائیں:

bash ./install.sh

سیٹ اپ گائیڈ کنکشن اور ایکٹیویشن کا احاطہ کرتی ہے، جبکہ انجن سلیکشن گائیڈ معاون ماڈل اور بیک اینڈ کے امتزاج کی وضاحت کرتی ہے۔

ایکٹیویشن موڈ منتخب کریں

تصدیق شدہ رابطے

تصدیق شدہ رابطے پہلے سے طے شدہ موڈ ہے۔ یہ منتخب پروفائل صرف ان پیغامات پر لاگو ہوتا ہے جو منظور شدہ چینل، اکاؤنٹ اور رابطے سے وابستہ ہوں۔ ہر نیا پیغام تصدیق شدہ چینل کے ذریعے آنا چاہیے۔ پیغام کے متن میں محض بھیجنے والے کی آئی ڈی شامل کرنے سے رسائی حاصل نہیں ہوتی۔

یہ موڈ abliteration کو منظور شدہ صارفین اور چینلز تک محدود رکھتا ہے، جس سے یہ خطرہ کم ہوتا ہے کہ کوئی غیر مجاز صارف بدنیتی پر مبنی prompt injection کے ذریعے اسے فعال کر دے۔ ٹول کے نتائج اور عمل درآمد اب بھی harness میں نافذ کردہ تحفظات اور اجازتوں پر منحصر ہیں۔

ہمیشہ فعال

ہمیشہ فعال موڈ FlashAlign کے ذریعے بھیجی جانے والی ہر درخواست پر تشکیل شدہ پروفائل لاگو کرتا ہے، جس میں ٹول اور subagent کی درخواستیں بھی شامل ہیں۔ منتخب موڈ دوبارہ شروع ہونے کے بعد بھی برقرار رہتا ہے، فی ٹول alignment کی ترتیبات کو نظر انداز کرتا ہے، اور کال کرنے والوں کو تصدیق شدہ قرار نہیں دیتا۔ جب تشکیل شدہ پروفائل لاگو نہ ہو سکے تو درخواستیں ناکام ہو جاتی ہیں۔

Always On موڈ میں براہِ راست انسٹال کرنے کے لیے:

bash ./install.sh --auto --mode always_on

حسب ضرورت harnesses اور OpenAI-compatible کلائنٹس پروجیکٹ کا Always On گیٹ وے استعمال کر سکتے ہیں۔ یاد رکھیں کہ FlashAlign کے راستوں یا گیٹ وے کو نظر انداز کرنے والی درخواستیں FlashAlign کے کنٹرول میں نہیں ہوتیں۔

رابطوں کو منظور اور منسوخ کریں

Verified contacts موڈ میں، بھیجنے والے کو منظور کرنے کے لیے انتظامی اسکرپٹ استعمال کریں۔ نمونہ فون نمبر اور اکاؤنٹ کو اپنے harness میں تسلیم شدہ شناخت کنندگان سے تبدیل کریں:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json approve whatsapp +15550000011 --account default

منظوریاں منسوخ کیے جانے تک دوبارہ شروع ہونے کے بعد بھی برقرار رہتی ہیں۔ معاونت یافتہ پیغام رسانی ذرائع پر تصاویر، صوتی نوٹس، منسلکات، آگے بھیجا گیا یا حوالہ دیا گیا مواد، اور قطار میں موجود پیغامات کے گروپس harness کے ذریعے بھیجنے والے کی تصدیق برقرار رکھتے ہیں۔

رابطہ منسوخ کرنے کے لیے:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json revoke whatsapp +15550000011 --account default

منسوخی بعد کی ماڈل درخواستوں، بشمول تفویض کردہ کام، کو متاثر کرتی ہے۔ یہ Always On موڈ کو غیر فعال نہیں کرتی۔

طے کریں کہ آیا ٹولز پروفائل حاصل کریں

Verified contacts موڈ آپ کو انسٹالیشن کے دوران ایک ڈیفالٹ مقرر کرنے اور انفرادی ٹولز کو نام کے ذریعے override کرنے دیتا ہے۔ مثال کے طور پر:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json tool delegate_task off
python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json tool sessions_spawn on

فعال ٹول موجودہ پروفائل تصدیق شدہ child work کو منتقل کر سکتا ہے۔ غیر فعال ٹول معیاری ماڈل استعمال کرتا ہے اور اپنے children کو کوئی پروفائل منتقل نہیں کرتا۔ آپ کا harness اب بھی یہ کنٹرول کرتا ہے کہ ٹول کو عمل درآمد کی اجازت ہے یا نہیں۔

Always On ان فی ٹول flags کو نظر انداز کرتا ہے اور ہر بھیجے گئے ٹول اور subagent کی درخواست پر پروفائل لاگو کرتا ہے۔ FlashAlign ان flags کو برقرار رکھتا ہے تاکہ بعد میں Verified contacts موڈ پر واپس آنے کی صورت میں یہ دستیاب رہیں۔

دوبارہ شروع کیے بغیر موڈ تبدیل کریں

موجودہ harness deployment کو دوبارہ شروع کیے بغیر Always On میں تبدیل کیا جا سکتا ہے:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json mode always_on

رابطہ پر مبنی رسائی پر واپس آنے کے لیے:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json mode verified

موڈ کا انتخاب دوبارہ شروع ہونے کے بعد بھی برقرار رہتا ہے، لیکن موڈ تبدیل کرنے سے پہلے سے غیر فعال deployment دوبارہ فعال نہیں ہوتا۔ صرف engine والی تنصیبات کے لیے، setup wizard کے activation مرحلے کے ذریعے موڈ تبدیل کریں۔

اعلیٰ درجے کی تنصیب اور معائنے کے نکات

تبدیلیاں کرنے سے پہلے ماحول کا پتا لگائیں

دستیاب ماڈلز، harnesses اور setup کے انتخاب پہلے دیکھنے کے لیے detection mode چلائیں:

bash ./install.sh --detect

کسی دوسری ڈائریکٹری سے پروفائلز لوڈ کریں

حسب ضرورت پروفائل فولڈر کی طرف installer کو متوجہ کریں:

bash ./install.sh --profiles /path/to/profiles

پروفائلز کا منتخب ماڈل اور engine سے مطابقت رکھنا اب بھی ضروری ہے۔ activation سے پہلے پروفائل کے metadata کا جائزہ لیں، یہ فرض نہ کریں کہ ایک پروفائل مختلف checkpoints میں قابل تبادلہ ہے۔

پروفائل کے مشمولات کا معائنہ کریں

مقامی پروفائل کے model pin، operators، sites، ranks اور hashes کی تصدیق کے لیے repository کی profile inspector guide استعمال کریں۔ ڈاؤن لوڈ کیے گئے یا الگ سے محفوظ پروفائل کو deploy کرنے سے پہلے یہ خاص طور پر مفید ہے۔

لوڈنگ اور تبدیلی کی منصوبہ بندی کریں

FlashAlign فی درخواست صرف ان پروفائلز کے درمیان تبدیل ہو سکتا ہے جو engine پہلے ہی لوڈ کر چکا ہو۔ کسی دوسرے ماڈل یا پروفائل کو لوڈ کرنا الگ تیاری کا مرحلہ ہے اور اس سے engine دوبارہ شروع ہو سکتا ہے۔ کم تاخیر والی routing کے لیے، درخواستیں فراہم کرنے سے پہلے اپنی application کو درکار پروفائلز لوڈ کر لیں۔

حسب ضرورت کلائنٹ یا harness کو مربوط کریں

براہِ راست پروگراماتی رسائی کے لیے direct engine and Python client guide کی پیروی کریں۔ Harness developers custom harness documentation میں بیان کردہ hooks استعمال کر سکتے ہیں۔ دیگر پیغام رسانی ذرائع دستاویزی adapter interface نافذ کر سکتے ہیں۔

سکیورٹی اور عملیاتی امور

• جب پروفائل کا استعمال معلوم چینلز، اکاؤنٹس اور بھیجنے والوں تک محدود رکھنا ہو تو Verified contacts کو ترجیح دیں۔
• Always On صرف اسی وقت استعمال کریں جب تشکیل شدہ روٹ کے ذریعے بھیجی جانے والی ہر درخواست کو پروفائل موصول ہونا چاہیے۔
• پیغام کے متن میں لکھے گئے کسی شناختی نشان کو بھیجنے والے کی شناخت کا ثبوت نہ سمجھیں۔
• ہارنس کی اجازت اور ٹول پر عمل درآمد کے کنٹرولز فعال رکھیں؛ FlashAlign ان کی جگہ نہیں لیتا۔
• سیٹ اپ یا تشکیل میں تبدیلیوں کے بعد مؤثر پروفائل کے جواب کی جانچ کریں۔
• پروڈکشن میں تعیناتی سے پہلے پروجیکٹ کے سیکیورٹی ماڈل، مطابقت کی حدود اور توثیقی نتائج کا جائزہ لیں۔

نتیجہ

FlashAlign معاونت یافتہ الائنمنٹ پروفائلز لاگو کرنے کا ایک قابلِ واپسی طریقہ فراہم کرتا ہے، جس میں ماڈل کے وزن مستقل طور پر تبدیل نہیں ہوتے۔ پن کیے گئے ماڈل اور مطابقت رکھنے والے انجن سے آغاز کریں، انسٹالر کے ذریعے تعیناتی تیار اور تصدیق کریں، اور اپنی رسائی کی ضروریات کے مطابق Verified contacts یا Always On منتخب کریں۔ زیادہ پیچیدہ تعیناتیوں کے لیے پروفائل کا معائنہ، فی ٹول وراثت، انجن تک براہِ راست رسائی اور حسبِ ضرورت ہارنس ہُکس اضافی کنٹرول فراہم کرتے ہیں۔

FlashAlign AGPL-3.0-only لائسنس کے تحت دستیاب ہے، جبکہ کلوزڈ سورس مصنوعات اور ہوسٹڈ سروسز کے لیے تجارتی لائسنس بھی پیش کیے جاتے ہیں۔ ماڈل، پروفائل اور انحصارات کی شرائط الگ رہتی ہیں۔