English 
Español 
日本語 
한국어 
简体中文 
ไทย 
Português 
Français 
Italiano 
Deutsch 
हिन्दी 
বাংলা 
Dansk 
Svenska 
Polski 
Русский 
العربية 
Tiếng Việt 
Türkçe 
Nederlands 
Bahasa Indonesia اکثر پوچھے جانے والے سوالات
وہ سوال جو سب سے زیادہ آتے ہیں: انسٹال کرنا اور ہٹانا، خرچ، آپ کی مشین سے باہر کیا جاتا ہے، اور یہ کیا پہچان سکتا ہے۔ اس سے لمبی ہر بات دستاویزات میں ہے۔
انسٹال، اپ ڈیٹ، اَن انسٹال
انسٹال اسکرپٹ آپ کی مشین پر ٹھیک دو جگہوں کو چھوتا ہے، اور دونوں جب چاہیں مٹائی جا سکتی ہیں۔
اسے چلانے کے لیے مجھے کیا چاہیے؟
ایک مشین جس پر Python 3.11 یا اس سے نیا ورژن ہو، اور تقریباً بس یہی۔ macOS arm64, Linux amd64 اور Windows amd64 تینوں پر وہی ایک خالص Python ریلیز چلتی ہے، GPU کی ضرورت نہیں۔ سسٹم کی ffmpeg بائنری صرف کھینچنے اور سننے والے سورسز (RTSP, RTMP, SRT) کے لیے چاہیے؛ ویب کیم، فائل یا براؤزر UI کو اس کی ضرورت نہیں۔
انسٹال اسکرپٹ چیزیں کہاں رکھتا ہے؟
دو جگہوں پر۔ ~/.cardstream انسٹال کی جڑ ہے: venv/ میں virtualenv اور models/ میں ماڈل ویٹس۔ دونوں کمانڈز، cardstream-web اور cardstream-client، چھوٹے shim ہیں جو ~/.local/bin میں لکھے جاتے ہیں؛ وہ venv کی بائنریز کو ماڈلز کے پاتھ پہلے سے بھر کر چلاتے ہیں، اس لیے آپ جو بھی فلیگ دیں وہی چلتا ہے۔ دونوں جگہیں CARDSTREAM_HOME اور INSTALL_DIR سے بدلی جا سکتی ہیں۔ مشین پر کسی اور چیز کو ہاتھ نہیں لگایا جاتا۔ خاص طور پر اسکرپٹ آپ کا shell پروفائل کبھی نہیں بدلتا: اگر ~/.local/bin آپ کے PATH پر نہ ہو تو وہ ایک نوٹ دکھا دیتا ہے اور تبدیلی آپ پر چھوڑ دیتا ہے۔
نئے ورژن پر اپ ڈیٹ کیسے کروں؟
وہی ایک سطری کمانڈ دوبارہ چلائیں۔ وہ موجودہ virtualenv میں تازہ ریلیز انسٹال کر دیتی ہے اور shim دوبارہ لکھ دیتی ہے۔ جو ویٹس پہلے سے ~/.cardstream/models میں پڑے ہیں انہیں نہیں چھیڑا جاتا (وہ صرف تب آتے ہیں جب موجود نہ ہوں)، اس لیے اپ ڈیٹ ایک چھوٹا سا ڈاؤن لوڈ ہے، مزید چوتھائی گیگا بائٹ نہیں۔ تازہ ترین کی جگہ کوئی خاص ریلیز چاہیے ہو تو CARDSTREAM_VERSION سیٹ کریں۔
# وہی ایک سطری کمانڈ؛ cardstream.ai/install.sh آپ کو main والے اسکرپٹ پر بھیج دیتا ہے $ curl -fsSL https://cardstream.ai/install.sh | sh $ curl -fsSL https://cardstream.ai/install.sh | CARDSTREAM_VERSION=v0.5.0 sh $ cardstream-web --version
اسے اَن انسٹال کیسے کروں؟
دو کمانڈز سے۔ پہلی virtualenv اور ماڈل ویٹس ہٹاتی ہے، دوسری دونوں shim۔ اس کے علاوہ صاف کرنے کو کچھ نہیں: نہ کوئی daemon، نہ login item، نہ سسٹم پیکج۔
$ rm -rf ~/.cardstream # venv/ + models/ $ rm -f ~/.local/bin/cardstream-web ~/.local/bin/cardstream-client
اگر انسٹال کے وقت CARDSTREAM_HOME یا INSTALL_DIR سیٹ تھا تو ان کی جگہ وہی پاتھ ہٹائیں، اور اگر shim کسی سسٹم ڈائریکٹری میں رکھے تھے تو sudo استعمال کریں۔ جو کچھ آپ نے خود شامل کیا تھا اسے ہٹانا بھی آپ ہی کا کام ہے: shell پروفائل میں PATH والی سطر، XIMILAR_API_KEY کا export، اور ہر وہ فولڈر جو آپ نے --store-images کو دیا تھا۔ ایپ آپ کی ہوم ڈائریکٹری میں اور کچھ نہیں لکھتی۔ نئے shell میں command -v cardstream-web چلا کر دیکھ لیں کہ یہ ہٹ چکا ہے؛ پرانا shell تب تک پرانا نتیجہ یاد رکھتا ہے جب تک hash -r نہ چلایا جائے۔
خرچ کتنا ہے اور کیا کچھ چاہیے
بیچ میں کوئی پلیٹ فارم نہیں: آپ کا ہارڈ ویئر، آپ کی کلید، اور ایک انجن جس کا کام ہی یہ ہے کہ کم سے کم کالز کرے۔
کیا مجھے Ximilar API کلید چاہیے؟
طے شدہ پہچان کے لیے، جی ہاں۔ اور پورے سسٹم کو بس یہی ایک کلید چاہیے۔ ximilar.com سے حاصل کریں اور شروع کرنے سے پہلے اسے XIMILAR_API_KEY کے نام سے export کریں۔ اگر اس کی جگہ اپنا پہچان کا سسٹم جوڑیں تو آپ کو وہی چاہیے جو اس اینڈ پوائنٹ کو چاہیے، اور Ximilar سے کچھ نہیں۔
$ export XIMILAR_API_KEY=your-key
cardstream خود کتنے کا ہے؟
مفت ہے۔ نہ سبسکرپشن، نہ فی صارف لائسنس، نہ پلیٹ فارم فیس: کھلے لائسنس والا ایک Python پیکج جو آپ کے اپنے ہارڈ ویئر پر چلتا ہے، اور ڈیٹیکشن کے ویٹس ریلیزز کے ساتھ Apache-2.0 کے تحت شائع ہوتے ہیں۔ پیسے پہچان کی کالز کے لگتے ہیں، جس اینڈ پوائنٹ سے بھی جوڑیں، اور اس گنتی کو کم رکھنا ہی لوکل انجن کا پورا مقصد ہے: آپ کے دکھائے ہوئے ہر الگ کارڈ پر تقریباً ایک کال، یعنی ایک گھنٹے میں کوئی سو، جہاں ہر فریم پر کال کرنے والی سیدھی سادی پائپ لائن 15 fps پر 54,000 کالز کر ڈالتی۔ شو کو اپنے Ximilar اکاؤنٹ میں محفوظ کرنے پر ہر شو کے لیے ایک سیشن شروع کرنے کے پیسے لگتے ہیں؛ دوبارہ چلانے کے بعد اسے جاری رکھنا مفت ہے۔
کیا اپنے ماڈلز یا اپنا پہچان کا سسٹم استعمال ہو سکتا ہے؟
دونوں۔ کارڈ لوکیٹر اور شناخت کا فلٹر بیک اینڈ کے حساب سے چلتے ہیں: ساتھ آنے والا RF-DETR .onnx ایکسپورٹ، RT-DETRv2 والا ایکسپورٹ، یا جب تک فائن ٹیوننگ پر کام جاری ہو تب تک transformers ڈائریکٹری یا hub id۔ اس کے پیچھے پہچان کا مرحلہ محض ایک اینڈ پوائنٹ ہے، اس لیے اسے اپنے پہچان کے سسٹم کی طرف موڑنے پر اس کے آگے لگا ہر فلٹر، رفتار کی ہر پابندی اور ہر کول ڈاؤن جوں کا توں رہتا ہے۔ دیکھیں ماڈل بیک اینڈز اور ماڈلز کی فہرست۔
ہارڈ ویئر، اسٹریمز اور حفاظت
یہ آپ کے شو کے ساتھ ساتھ اسی مشین پر چلتا ہے جس سے آپ کی اسٹریم پہلے سے جاتی ہے۔
کیا مجھے GPU چاہیے؟
نہیں۔ ساتھ آنے والے ویٹس CPU کے حساب سے بنے ONNX ایکسپورٹس ہیں، اور لوکل انجن جو کچھ بھی کرتا ہے (حرکت کا فلٹر، ڈیٹیکشن کی رفتار کی پابندی، اور وہ ایمبیڈنگ جو ”وہی کارڈ یا نیا کارڈ؟“ کا جواب دیتی ہے) وہ سب اسی پروسیسر پر چلتا ہے جو آپ کے پاس پہلے سے ہے۔ GPU آپ کے اپنے زیادہ درستگی والے ویٹس کے لیے ایک آپشن ہے، طے شدہ سیٹنگز کے لیے کبھی لازمی نہیں۔
کیا یہ Whatnot یا Fanatics Live کے ساتھ چلتا ہے؟
جی ہاں، مگر مارکیٹ پلیس سے جڑ کر نہیں: یہ وہی ویڈیو لیتا ہے جو آپ کے ہاں پہلے سے بن رہی ہے۔ OBS کا ورچوئل کیمرا، پلیٹ فارم کو جانے والے آؤٹ پٹ کے ساتھ دوسرا RTMP یا SRT آؤٹ پٹ، انکوڈر سے RTSP کے ذریعے کھینچنا، یا بس اسی میٹ کی طرف کیا ہوا اس کا اپنا کیمرا۔ لائیو بیچنے والوں کی گائیڈ چاروں طریقے شروع سے آخر تک بتاتی ہے۔
میری مشین سے اصل میں باہر کیا جاتا ہے؟
کلائنٹ سائیڈ موڈ میں، ہر الگ کارڈ کا ایک JPEG کراپ۔ نہ اسٹریم، نہ اس کے آس پاس کے فریمز، نہ باقی میٹ۔ کچھ بھیجنا ہے یا نہیں، یہ ہر فیصلہ پہلے لوکل ہوتا ہے، اس لیے ایک گھنٹے کی ویڈیو جس میں آپ نے سو کارڈز دکھائے، سو چھوٹی ریکویسٹس بنتی ہے۔ واحد استثنا وہ ہے جسے آپ خود آن کریں: --ximilar-stream کے ساتھ شو کی ہسٹری (ہر کارڈ کی ایک متنی قطار اور وہ کراپ جس سے وہ پہچانا گیا) آپ کے اپنے Ximilar اکاؤنٹ کے ایک سیشن میں بھی محفوظ ہو جاتی ہے۔ طے شدہ طور پر بند، اور --no-ximilar-stream-images کے ساتھ صرف متن جاتا ہے۔
کیا شو کے بعد اس کا جائزہ لیا جا سکتا ہے؟
جی ہاں، اگر آپ اسے محفوظ کریں۔ --ximilar-stream NEW کے ساتھ شروع کریں تو ہسٹری میں آنے والا ہر کارڈ (اپنی قیمت، اسٹریم پر گزرے وقت اور اس کراپ سمیت جس سے وہ پہچانا گیا) شو کے ساتھ ساتھ آپ کے Ximilar اکاؤنٹ کے ایک سیشن میں جاتا رہتا ہے۔ بعد میں Ximilar ایپ کا Cardstream حصہ کھولیں: شو کی مالیت، اس کے سب سے قیمتی پروڈکٹس اور سرفہرست سیٹس، ہر کارڈ اپنی تصویر کے ساتھ؛ جو بک گیا اس پر نشان لگائیں اور غلط میچ درست کریں۔ شو کے بیچ میں دوبارہ چلانا پڑا؟ NEW کی جگہ سیشن id دیں تو شو جاری رہتا ہے، چاہے سیشن بند ہو چکا ہو۔ ٹیم کے ورک اسپیس میں محفوظ کرنے کے لیے --ximilar-workspace درکار ہے۔ پوری تفصیل۔
$ cardstream-web --price-stats --ximilar-stream NEW کیا اسے اپنے LAN پر چلایا جا سکتا ہے تاکہ دوسری مشین UI کھول سکے؟
ایسا نہ کریں۔ ویب UI پر کوئی لاگ ان نہیں اور اس کے پاس آپ کی API کلید ہوتی ہے، اس لیے اس کی جگہ 127.0.0.1 ہے اور کہیں نہیں۔ کنٹینر اندر سے 0.0.0.0 پر بائنڈ ہوتا ہے، اور اسی لیے دستاویزات والی docker run کمانڈ پورٹ صرف 127.0.0.1 پر کھولتی ہے۔ اگر واقعی کسی دوسری مشین سے رسائی چاہیے تو پورٹ کھولنے کے بجائے اس کے آگے اپنا لاگ ان والا ٹنل لگائیں۔
$ docker run --rm -e XIMILAR_API_KEY -p 127.0.0.1:8001:8001 \ -v cardstream-models:/models cardstream
یہ کیا پہچانتا ہے، اور کتنے اعتماد سے
ہر میچ اپنے فاصلے، اپنے درجے اور ان کارڈز کے ساتھ آتا ہے جو اس کی جگہ ہو سکتے تھے۔
یہ کون سے کارڈز پہچان سکتا ہے؟
چار کیٹیگریز، ایک سوئچ۔ ٹریڈنگ کارڈ گیمز: Pokémon, Magic: The Gathering, Yu-Gi-Oh!, One Piece, Lorcana اور تقریباً بیس مزید، نئے اور ونٹیج سنگل کارڈز سیدھے اسٹریم سے پڑھے جاتے ہیں۔ ہر بڑے کھیل کے اسپورٹس کارڈز، پیرالل اور سال تک۔ گریڈڈ سلیبز، کیس توڑے بغیر لیبل سے پڑھے جاتے ہیں۔ اور کامکس، عنوان، شمارے اور سال سے۔ کیٹیگری ایک فلیگ سے چنی جاتی ہے، یا سیٹنگز کا ڈائیلاگ اسے اسٹریم کے دوران بدل دیتا ہے۔ پوری فہرست دیکھیں۔
اگر یہ غلط کارڈ بتا دے تو کیا ہوتا ہے؟
آپ کو پہلے ہی پتا چل جاتا ہے۔ ہر میچ کے ساتھ خام فاصلہ اور High / Medium / Low درجہ آتا ہے (حدیں 0.30 اور 0.40 پر ہیں)، اور ساتھ زیادہ سے زیادہ چار متبادل کارڈز جو اس کی جگہ ہو سکتے تھے؛ درست کارڈ عموماً اسی مختصر فہرست میں ہوتا ہے۔ نتیجے کی حد مقرر کر دیں تو اس سے نیچے کی کوئی چیز اوورلے تک پہنچتی ہی نہیں۔ اگر پورا شو ایک ہی گیم یا ایک ہی سیٹ کا ہو تو پری فل تلاش کو شروع ہونے سے پہلے ہی محدود کر دیتے ہیں: اسے گیم، سیٹ کوڈ یا رسم الخط بتا دیں تو اینڈ پوائنٹ ان کا اندازہ لگانا چھوڑ دیتا ہے۔
اوپن سورس۔ سیلف ہوسٹڈ۔ آپ کی اسٹریم، آپ کا اسٹیک۔
بیچ میں کوئی پلیٹ فارم نہیں، فی صارف لائسنس نہیں: Ximilar API یا اپنا پہچان کا سسٹم جوڑیں، اور cardstream اسے ہر فریم پر نہیں، ہر الگ کارڈ پر ایک بار کال کرتا ہے۔ چاہے Whatnot پر باکس بریک ہو، Fanatics Live جیسا شو ہو یا آپ کا اپنا لائیو کامرس سیٹ اپ، cardstream آج رات ہی اسی ہارڈ ویئر پر چلائیں جو آپ کے پاس پہلے سے ہے۔