AI رائٹر کے ذریعے مصنوعات کی تصاویر سے کثیر لسانی ای کامرس متن تیار کریں

AI Writer کیا ہے؟

AI Writer ایک اوپن سورس ایپلی کیشن ہے جو مصنوعات کی تصاویر کو قابلِ ترمیم ای کامرس وضاحتوں میں تبدیل کرتی ہے۔ آپ ایک سے آٹھ عوامی HTTPS تصویری URLs فراہم کر سکتے ہیں، آؤٹ پٹ زبان منتخب کر سکتے ہیں اور مسودہ تیار کرنے کے لیے OpenAI کے وژن کی صلاحیت رکھنے والے Chat Completions ماڈل کا استعمال کر سکتے ہیں۔

یہ ایپلی کیشن انگریزی، ترکی، ہسپانوی، جرمن، فرانسیسی اور چینی زبانوں کو سپورٹ کرتی ہے۔ اس میں اکاؤنٹ کی توثیق، براؤزر پر مبنی ترمیم، ترجمہ اور MySQL سے تقویت یافتہ کریڈٹ سسٹم بھی شامل ہے۔

AI Writer مسودے تیار کرتا ہے، تصدیق شدہ مصنوعات کی تفصیلات نہیں۔ ہر وضاحت کو شائع کرنے سے پہلے ضرور جانچیں، کیونکہ تصاویر پیمائش، کپڑے کی ساخت یا سرٹیفیکیشن جیسی تفصیلات کا قابلِ اعتماد ثبوت فراہم نہیں کر سکتیں۔

اہم خصوصیات

• تصویر پر مبنی تحریر: عوامی طور پر قابلِ رسائی ایک سے آٹھ HTTPS مصنوعات کی تصاویر سے متن تیار کریں۔
• پروڈکٹ پیج حاصل کرنا: عوامی پروڈکٹ پیج سے تصویری لنکس جمع کرنے کے لیے Puppeteer استعمال کریں۔
• آؤٹ پٹ کی چھ زبانیں: انگریزی، ترکی، ہسپانوی، جرمن، فرانسیسی یا چینی میں مواد تیار کریں۔
• ترمیم اور ترجمہ: براؤزر میں تیار کردہ مسودوں کو بہتر بنائیں، انہیں کاپی کریں اور ایک کارروائی میں ترجمہ کریں۔
• اکاؤنٹس اور کریڈٹس: ایپلی کیشن bcrypt پاس ورڈز، MySQL سیشنز اور ایسے بیلنس کا استعمال کرتی ہے جو بیک وقت ضرورت سے زیادہ خرچ ہونے سے تحفظ فراہم کرتا ہے۔
• ناکامی پر رقم کی واپسی: معاونت یافتہ جنریشن درخواستیں ناکام ہونے پر محفوظ کیے گئے کریڈٹس واپس کر دیے جاتے ہیں۔
• تجرباتی ویڈیو ان پٹ: مختصر YouTube ویڈیو سے زیادہ سے زیادہ آٹھ فریم نکالیں اور انہیں بصری ان پٹ کے طور پر استعمال کریں۔

ضروریات

انسٹالیشن سے پہلے درج ذیل تیار کریں:

• Node.js 22.12 یا اس کے بعد کا ورژن اور npm۔
• Compose کے ساتھ Docker، یا MySQL 8 یا اس کے بعد کے ورژن والے موجودہ سرور تک رسائی۔
• وژن کی صلاحیت رکھنے والے Chat Completions ماڈل تک رسائی والی OpenAI API key۔
• اگر آپ پروڈکٹ پیجز سے تصاویر حاصل کرنا چاہتے ہیں تو Puppeteer کے ذریعے انسٹال کیا گیا Chrome۔
• اگر آپ تجرباتی ویڈیو پروسیسنگ آزمانا چاہتے ہیں تو PATH پر دستیاب FFmpeg اور FFprobe۔

اگر آپ صرف تصاویر سے وضاحتیں تیار کرنا چاہتے ہیں تو FFmpeg اختیاری ہے۔

AI Writer خودکار طور پر انسٹال کریں

انٹرایکٹو سیٹ اپ اسکرپٹ انسٹالیشن کا آسان ترین طریقہ ہے۔ ریپوزٹری کلون کریں، اس کی ڈائریکٹری میں جائیں، انسٹالر چلائیں اور ایپلی کیشن شروع کریں:

git clone https://github.com/csadigital/ai-writer.git
cd ai-writer
npm run setup
npm start

انسٹالر ایپلی کیشن کی dependencies اور Chrome ڈاؤن لوڈ کرتا ہے، آپ کی OpenAI API key کو دکھائے بغیر طلب کرتا ہے، ڈیٹابیس اور سیشن کے secrets بناتا ہے اور MySQL کو ابتدائی حالت میں لاتا ہے۔ یہ موجودہ .env اقدار برقرار رکھتا ہے اور مقامی بیک اپ بناتا ہے۔

سیٹ اپ کے دوران مستقل MySQL کنٹینر خودکار طور پر شروع کرنے کے لیے docker منتخب کریں۔ Docker پہلے سے انسٹال اور چل رہا ہونا چاہیے۔ اپنے MySQL سرور سے منسلک ہونے کے لیے existing منتخب کریں۔ ایڈمنسٹریٹر کی اسناد کے ساتھ انسٹالر مخصوص ڈیٹابیس اور ایپلی کیشن صارف بنا سکتا ہے؛ یہ ایڈمنسٹریٹر کا پاس ورڈ محفوظ نہیں کرتا۔

شروع ہونے کے بعد اپنے براؤزر میں http://localhost:3000 کھولیں۔

Docker ڈیٹابیس روکیں

مستقل ڈیٹا حذف کیے بغیر مقامی MySQL کنٹینر روکنے کے لیے یہ چلائیں:

docker compose -f compose.mysql.yml stop

.env میں ڈیٹابیس کی اسناد تبدیل کرنے سے پہلے سے ابتدائی حالت میں لائے گئے Docker volume کو ری سیٹ نہیں کیا جاتا۔ اصل اسناد برقرار رکھیں یا باقاعدہ ڈیٹابیس منتقلی کریں۔

AI Writer دستی طور پر انسٹال کریں

دستی سیٹ اپ آپ کو ماحول اور ڈیٹابیس کی ترتیب پر براہِ راست کنٹرول دیتا ہے۔ پروجیکٹ کلون کریں، اس کی مخصوص dependencies انسٹال کریں اور ماحول کی فائل بنائیں:

git clone https://github.com/csadigital/ai-writer.git
cd ai-writer
npm ci
cp .env.example .env
node -e "console.log(require('node:crypto').randomBytes(32).toString('hex'))"

تیار کردہ قدر کو .env میں SESSION_SECRET میں درج کریں۔ اس secret میں کم از کم 32 حروف ہونے چاہییں۔ پھر اپنی OpenAI API key اور MySQL کنکشن کی ترتیبات شامل کریں۔ نئی اسناد استعمال کریں اور .env فائل کو کبھی commit نہ کریں۔

MySQL ایڈمنسٹریٹر کے ذریعے ڈیٹابیس اور ایپلی کیشن صارف بنائیں، اس صارف کو ڈیٹابیس تک رسائی دیں اور schema.sql کے ذریعے ٹیبلز کو ابتدائی حالت میں لائیں:

mysql -h 127.0.0.1 -u ai_writer -p ai_writer < schema.sql
npm start

http://localhost:3000 کھولیں، اکاؤنٹ بنائیں اور سائن اِن کریں۔

ماحول ترتیب دیں

ایپلی کیشن اپنی ترتیبات ماحول کے variables سے پڑھتی ہے۔ کم از کم OpenAI credential، session secret اور ڈیٹابیس کنکشن ترتیب دیں۔

• OPENAI_API_KEY: مطلوبہ OpenAI API credential۔
• OPENAI_MODEL: وژن کی صلاحیت رکھنے والا Chat Completions ماڈل۔ ڈیفالٹ gpt-4.1-mini ہے۔
• SESSION_SECRET: کم از کم 32 حروف پر مشتمل مطلوبہ بے ترتیب secret۔
• DB_HOST اور DB_PORT: MySQL کا پتہ۔ ڈیفالٹس 127.0.0.1 اور 3306 ہیں۔
• DB_USER اور DB_PASSWORD: مقامی MySQL ایپلی کیشن کی اسناد۔
• DB_NAME: ڈیٹابیس کا نام۔ ڈیفالٹ ai_writer ہے۔
• PORT: ایپلی کیشن کا HTTP پورٹ۔ ڈیفالٹ 3000 ہے۔
• NODE_ENV: رن ٹائم موڈ۔ ڈیفالٹ development ہے۔
• TRUST_PROXY: طے کریں کہ آیا ایپلی کیشن ایک HTTPS ریورس پراکسی پر اعتماد کرے۔ ڈیفالٹ 0 ہے۔

منتخب کردہ ماڈل کو Chat Completions API کے ذریعے تصویری ان پٹ کو سپورٹ کرنا چاہیے۔ مطابقت رکھنے والے درخواست کے طریقۂ کار کے لیے OpenAI کی سرکاری تصویری ان پٹ گائیڈ دیکھیں۔

اپنی پہلی پروڈکٹ کی تفصیل تیار کریں

1. اکاؤنٹ بنائیں: مقامی ایپلیکیشن کے ذریعے رجسٹر کریں اور سائن اِن کریں۔ ہر نئے اکاؤنٹ کو ابتدا میں دس کریڈٹس ملتے ہیں۔
2. پروڈکٹ کی تصاویر شامل کریں: ایک سے آٹھ عوامی HTTPS تصویری URLs فراہم کریں۔ ماڈل کو ان URLs تک رسائی حاصل ہونی چاہیے۔
3. زبان منتخب کریں: انگریزی، ترکی، ہسپانوی، جرمن، فرانسیسی یا چینی منتخب کریں۔
4. مسودہ تیار کریں: بصری تجزیے اور تفصیل کی تیاری کے لیے تصاویر جمع کرائیں۔
5. نتیجہ ترمیم کریں: براؤزر میں مسودے کا جائزہ لیں اور غیرمصدقہ دعووں، لہجے یا پروڈکٹ کی تفصیلات کو درست کریں۔
6. متن کاپی کریں: نظرثانی شدہ تفصیل کو اپنے ای کامرس ورک فلو میں کاپی کریں۔

تفصیل کی کامیاب تیاری پر ایک کریڈٹ خرچ ہوتا ہے۔ اگر تیاری کی درخواست ناکام ہو جائے تو ایپلیکیشن محفوظ کیا گیا کریڈٹ واپس کر دیتی ہے۔

مثالی تصویری ورک فلو

متعدد زاویوں والی پروڈکٹ کے لیے براہِ راست تصویری URLs کا ایک مختصر مجموعہ فراہم کریں، مثلاً:

https://example.com/products/item-front.jpg
https://example.com/products/item-side.jpg
https://example.com/products/item-detail.jpg

صرف عوامی HTTPS پتے استعمال کریں۔ متعدد مناظر ماڈل کو زیادہ قابلِ مشاہدہ سیاق فراہم کر سکتے ہیں، لیکن یہ آپ کے پروڈکٹ کیٹلاگ سے تصدیق شدہ خصوصیات کا متبادل نہیں ہیں۔

پروڈکٹ صفحے سے تصاویر حاصل کریں

ہر تصویری URL دستی طور پر جمع کرنے کے بجائے، AI Writer عوامی پروڈکٹ صفحے کا جائزہ لینے اور تصویری لنکس جمع کرنے کے لیے Puppeteer استعمال کر سکتا ہے۔ اس ورک فلو کے لیے Puppeteer کے زیرِ انتظام Chrome انسٹالیشن درکار ہے۔

1. صفحہ حاصل کرنے والے ورک فلو کو عوامی پروڈکٹ صفحے کا URL فراہم کریں۔
2. ایپلیکیشن کو ممکنہ تصویری لنکس جمع کرنے دیں۔
3. حاصل شدہ نتائج میں سے موزوں پروڈکٹ تصاویر منتخب کریں۔
4. حسبِ معمول تفصیل تیار کریں اور اس کا جائزہ لیں۔

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

موجودہ مسودے کا ترجمہ کریں

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

تجرباتی ویڈیو ورک فلو استعمال کریں

AI Writer مختصر YouTube ویڈیو سے زیادہ سے زیادہ آٹھ فریم نکال کر ان فریمز کو بصری سیاق کے طور پر جمع کرا سکتا ہے۔ مقامی فریمز کو ماڈل کے پاس ڈیٹا URLs کے طور پر بھیجا جاتا ہے، کیونکہ localhost کے تصویری لنکس API کے لیے قابلِ رسائی نہیں ہوں گے۔

ویڈیو کو ان تمام حدود پر پورا اترنا چاہیے:

• یہ لائیو ویڈیو نہیں ہونی چاہیے۔
• یہ تین منٹ سے زیادہ طویل نہیں ہونی چاہیے۔
• اس کا حجم 50 MB سے زیادہ نہیں ہونا چاہیے۔
• FFmpeg اور FFprobe، PATH پر دستیاب ہونے چاہییں۔
• آپ کو میڈیا پر کارروائی کرنے کا اختیار حاصل ہونا چاہیے۔

یہ سہولت بیرونی YouTube ڈاؤن لوڈر کی دستیابی پر منحصر ہے، اور YouTube خودکار ڈاؤن لوڈز مسترد کر سکتا ہے۔ ناکام کارروائی میں محفوظ کیا گیا کریڈٹ واپس کر دیا جاتا ہے۔

ترقی اور جانچ

ایپلیکیشن میں تبدیلیاں کرتے وقت ترقیاتی کمانڈ استعمال کریں:

npm run dev

پروجیکٹ کی جانچ، خودکار ٹیسٹ اور پروڈکشن انحصارات کا آڈٹ اس طرح چلائیں:

npm run check
npm test
npm audit --omit=dev

ٹیسٹ سوٹ توثیق، سیشن کی گردش، CSRF تحفظ، URL کی توثیق، escaped آؤٹ پٹ، تصویری تیاری، ترجمہ، کریڈٹ کی واپسی اور متوازی کریڈٹ خرچ کرنے کا احاطہ کرتا ہے۔ مقامی ٹیسٹ ڈیٹابیس اور AI سروسز کو الگ تھلگ رکھتے ہیں، اس لیے وہ پروڈکشن اسناد استعمال نہیں کرتے اور نہ ہی معاوضہ طلب API کالز کرتے ہیں۔ مسلسل انضمام installer schema کی تیاری اور ڈیٹابیس صارف کے اجازت ناموں کی تصدیق کے لیے عارضی حقیقی MySQL سرور بھی بناتا ہے۔

اعلیٰ درجے کی تجاویز

تصاویر احتیاط سے منتخب کریں

ایسی واضح تصاویر استعمال کریں جو پروڈکٹ کو مفید زاویوں سے دکھائیں۔ درخواست کو ایک سے آٹھ تصاویر کی حد میں رکھیں۔ اضافی تصاویر کو ایک ہی منظر دہرانے کے بجائے بامعنی بصری معلومات فراہم کرنی چاہیے۔

حقیقی معلومات کو بصری اندازوں سے الگ رکھیں

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

رازوں اور ڈیٹابیس تک رسائی کا تحفظ کریں

.env کو نجی رکھیں، مخصوص ڈیٹابیس اسناد استعمال کریں اور API keys یا سیشن راز commit کرنے سے گریز کریں۔ اگر آپ موجودہ MySQL سرور استعمال کرتے ہیں تو ایپلیکیشن صارف کو صرف اس کے مقررہ ڈیٹابیس تک رسائی دیں۔

عوامی تعیناتی سے پہلے تیاری کریں

AI Writer کو انٹرنیٹ پر دستیاب کرنے سے پہلے repository کی تعیناتی گائیڈ پڑھیں۔ عوامی سرور کے لیے HTTPS، محدود نیٹ ورک egress اور سینڈ باکس میں چلنے والا براؤزر ضروری ہے۔ صرف DNS validation، DNS rebinding کے خلاف مکمل دفاع نہیں ہے۔

بلٹ اِن کریڈٹس اخراجات کو محدود کرتے ہیں، لیکن اس پروجیکٹ میں billing integration، خودکار کریڈٹ خریداری، پاس ورڈ کی بازیابی یا ای میل کی توثیق شامل نہیں ہے۔ repository شائع کرنے سے بھی hosted application یا live demo نہیں بنتا۔

پروجیکٹ کی اہم فائلوں کو سمجھیں

• app.js: اکاؤنٹ اور کریڈٹ روٹس سمیت Express ایپلیکیشن۔
• db.js: MySQL کنکشن پول۔
• youtube.js: محدود تجرباتی ویڈیو ورک فلو۔
• lib/ai.js: ماڈل کی درخواستیں اور کثیر لسانی پرامپٹس۔
• lib/network.js: عوامی HTTPS URL کی توثیق۔
• views/: EJS صفحات اور مشترکہ لے آؤٹ۔
• public/: اسٹائلز، براؤزر کوڈ اور برانڈنگ۔
• schema.sql: اکاؤنٹ ڈیٹا بیس ٹیبل۔
• scripts/setup.js: تعاملی انسٹالر۔
• compose.mysql.yml: اختیاری مقامی MySQL سروس۔
• test/: خودکار رجعتی جانچیں۔

نتیجہ

AI Writer پروڈکٹ کی تصاویر کو کثیر لسانی ای کامرس مسودوں میں تبدیل کرنے کے لیے ایک عملی مقامی ورک فلو فراہم کرتا ہے۔ تعاملی انسٹالر سے آغاز کریں، وژن کی صلاحیت رکھنے والے OpenAI ماڈل سے کنکشن قائم کریں، عوامی HTTPS تصاویر شامل کریں، اور اشاعت سے پہلے ہر نتیجے کا جائزہ لیں۔ اس کے اکاؤنٹ، کریڈٹ، ترجمہ اور جانچ کے فیچرز ایک مضبوط بنیاد فراہم کرتے ہیں، جبکہ پروڈکشن ڈپلائمنٹس کے لیے اب بھی براؤزر آئسولیشن، نیٹ ورک کنٹرولز اور HTTPS پر محتاط توجہ درکار ہے۔