دستاویزاں

سب کجھ تہاڈی مشین اُتے چلدا اے: انسٹال کرو، ایہنوں کیمرا دیو، تے طے کرو کہ ایہنوں کال کرن دی اجازت کدوں اے۔ ترتیب ایس حساب نال اے کہ تسیں کرنا کیہ چاہندے او۔

انسٹال کرو تے چلاؤ

خالی ہتھ توں سکرین اُتے کارڈ تک

اک کمانڈ کلائنٹ، ماڈل ویٹس تے shim سکرپٹ انسٹال کر دیندی اے۔ پورے سسٹم وچ بس اِکو کنجی اے: تہاڈی Ximilar کنجی۔

انسٹال سکرپٹ

~/.cardstream وچ venv بناؤندا اے، ریلیز دے wheel نوں چیک سم نال پرکھدا اے، ماڈل ویٹس لیاؤندا اے تے دوویں کمانڈاں تہاڈے PATH اُتے رکھ دیندا اے۔ باقی طریقے (wheel، Docker، سورس) ڈاؤن لوڈ صفحے اُتے نیں۔

$ curl -fsSL https://raw.githubusercontent.com/Ximilar-com/cardstream/main/scripts/install.sh | sh

انسٹال دے سارے طریقے ←

ہتھیں انسٹال

checkout تے pip نال وی کم چل جاندا اے۔ extras اک دوجے توں وکھرے نیں: [client] وچ UI تے سورس نیں، تے [onnx] یا [torch] ڈیٹیکٹر تے ایمبیڈنگ دے بیک اینڈ دیندے نیں۔

$ git clone https://github.com/Ximilar-com/cardstream && cd cardstream
$ pip install -e '.[client,onnx]'

تہاڈی Ximilar کنجی

پچھان Ximilar collectibles/v2 دے زور تے چلدی اے۔ XIMILAR_API_KEY اوہ اِکو انوائرمنٹ ویری ایبل اے جیہڑا کِتے وی پڑھیا جاندا اے، باقی سب کجھ فلیگ اے۔

$ export XIMILAR_API_KEY=your-key

پہلی واری چلاؤنا

تہاڈے ویب کیم اُتے براؤزر UI کھولدا اے۔ کارڈ اگے کرو؛ اوورلے وکھاؤندا اے کہ سٹیٹ مشین کیہ سوچ رہی اے، تے میچ آؤندیاں ای اوہ وی۔

$ cardstream-web
# → http://127.0.0.1:8001

ویکھو تہاڈے کول کیہ اے

دوویں کمانڈاں اپنا ورژن وکھا کے بند ہو جاندیاں نیں۔ ماڈل فائلاں دی لوڑ نئیں، ایس لئی انسٹال مُکدیاں ای ایہہ کم کردا اے۔

$ cardstream-web --version
cardstream 0.5.0

بغیر براؤزر، سیٹ اپ لئی

اوہی پائپ لائن، براؤزر توں بغیر: نتیجے ٹرمینل وچ آؤندے نیں۔ فلیگ اوہی جیہڑے cardstream-web دے نیں، تے کیمرے دے نال اِکو پروسیس۔

$ cardstream-client --source 0

ورتو

ایہنوں اپنا شو دیو

سورس بدلے جا سکدے نیں تے جیہڑا وی چُنو، تجزیہ اوہی رہندا اے۔ ہر چیز اک فلیگ اے؛ ضروری سیٹنگاں، سیٹنگاں دے ڈائیلاگ توں لائیو بدلیاں جا سکدیاں نیں۔

ویب کیم تے فائلاں

cardstream-web دا ڈیفالٹ براؤزر والا ویب کیم اے؛ کیمرے دا انڈیکس، ویڈیو فائل یا اک کھلوتی تصویر ہر تھاں چلدی اے۔ شو توں پہلاں ٹیسٹ لئی ودھیا۔

$ cardstream-web # براؤزر والا ویب کیم
$ cardstream-client --source clip.mp4

سٹریم کھِچو

ایہنوں IP کیمرے، اِنکوڈر یا ری سٹریمر ول کرو: rtsp://، rtmp://، srt:// تے ws:// JPEG فیڈ، تے جے رابطہ ٹُٹے تاں ودھدے پر حد والے وقفیاں نال آپ ای دوبارہ جُڑدا اے۔

$ cardstream-web --source rtsp://cam/stream1

OBS نوں بھیجن دیو

ایہنوں لِسنر دے طور تے چلاؤ تے OBS وچ اک ہور RTMP یا SRT آؤٹ پُٹ لا دیو۔ سسٹم دا ffmpeg بائنری چاہیدا اے (brew install ffmpeg)۔

$ cardstream-web --source rtmp://0.0.0.0:1935/live --listen

پری فِل کھوج نوں تنگ کردے نیں

گیم، سیٹ کوڈ تے رسم الخط بھیجن توں پہلاں لوکل پرکھے جاندے نیں۔ جدوں وی --game دیو، --alphabet ضرور دیو، کیوں جے گیم دا پری فِل اینڈ پوائنٹ نوں رسم الخط آپ پچھانن توں روک دیندا اے۔

$ cardstream-web --game "Pokémon" --alphabet japanese --set-code M4

سیٹنگاں دا ڈائیلاگ

کیٹیگری، گیم، سیٹ کوڈ، رسم الخط تے حداں سٹریم دے دوران براؤزر توں ای بدلیاں جا سکدیاں نیں۔ دوبارہ چلاؤن دی لوڑ نئیں، تے کنٹرولاں اُتے اوہی پرکھ لگدی اے جیہڑی پروسیس اُتے۔

ریزولوشن دیاں تن سیٹنگاں

کیمرا کیہ پھڑدا اے، کیہ بھیجیا جاندا اے تے کیہدا تجزیہ ہوندا اے، ایہہ تِنّے وکھرے نمبر نیں۔ تجزیہ چھوٹی تصویر اُتے چلدا اے؛ پچھان والا کراپ پورے فریم توں دوبارہ کٹیا جاندا اے۔

$ cardstream-web --camera-width 3840 --width 1280

شو دا جائزہ

شو محفوظ کرو، بعد وچ جائزہ لوو

ڈیفالٹ وچ بند۔ اک فلیگ اوس ہسٹری نوں، جیہڑی صفحہ بناؤندا اے (جیہڑا وی کارڈ تسیں وکھایا، اپنے کراپ سمیت)، تہاڈے اپنے Ximilar اکاؤنٹ دے اک سیشن وچ محفوظ کر دیندا اے، تاں جے اگلی سویر وی شو اوتھے ای ہووے۔

ہسٹری، تھمب نیل سمیت

براؤزر UI اوہ ہر کارڈ وکھاؤندا اے جیہڑا تسیں وکھایا، سب توں نواں سب توں اُتے: پچھانے گئے کراپ دا تھمب نیل، اوہدی قیمت (جے --price-stats لگا ہووے)، تے اوہ سٹریم اُتے کِنّی دیر رہیا۔ ایہہ لسٹ تہاڈی مشین اُتے ای رہندی اے۔

شو محفوظ کرو

--ximilar-stream NEW اک سیشن شروع کردا اے تے اوہدا id وکھا دیندا اے۔ اوس توں بعد ہسٹری دی ہر قطار شو دے نال نال محفوظ ہوندی جاندی اے: اپ لوڈ پِچھے پِچھے اکٹھے ہو کے جاندے نیں، نیٹ ورک دی غلطی اُتے دوبارہ کوشش ہوندی اے، تے شو کدی نئیں رُکدا۔ صاف طریقے نال بند کرو تاں جو رہ گیا اوہ اپ لوڈ ہو جاندا اے تے سیشن بند ہو جاندا اے۔

$ cardstream-web --game "Pokémon" --alphabet latin \
    --price-stats --ximilar-stream NEW

شو محفوظ کرن دی پوری تفصیل ←

کیہ اپ لوڈ ہوندا اے

قطاراں ٹیکسٹ دے طور تے (کارڈ، سیٹ، قیمت، سٹریم اُتے ویلا، اوہدے پِچھے لگیاں پیسیاں والیاں کالاں) تے اوہ کراپ جیہدے توں ہر قطار پچھانی گئی، ودھ توں ودھ 1024 px: اوہی تصویر جیہڑی پچھان والی کال نوں پہلاں ای مل چکی اے۔ --no-ximilar-stream-images نال صرف ٹیکسٹ ای جاندا اے۔ تہاڈے Ximilar اکاؤنٹ اُتے Cardstream سروس ہونی چاہیدی اے۔

$ cardstream-web --ximilar-stream NEW --no-ximilar-stream-images

Ximilar ایپ وچ جائزہ لوو

ہر سیشن Ximilar ایپ دے Cardstream حصے وچ آ جاندا اے: تسیں کیہ وکھایا تے کدوں، شو دی ویلیو، سب توں مہنگے پروڈکٹ تے سب توں اُتلے سیٹ، تے ہر کارڈ اپنے کراپ سمیت۔ جو وِکیا اوہدے اُتے نشان لاؤ، غلط میچ ٹھیک کرو، نوٹ لکھو۔

Ximilar ایپ کھولو ←

دوبارہ چلا کے اوتھوں ای شروع کرو

NEW دی تھاں سیشن id دیو تے شو اوسے سیشن وچ چلدا رہندا اے۔ بھاویں صاف طریقے نال بند کرن اُتے سیشن بند ہو گیا ہووے، اوہ بس دوبارہ کھُل جاندا اے۔ پیسے صرف سیشن شروع کرن دے لگدے نیں، ایس لئی دوبارہ جاری کرن دا کوئی خرچہ نئیں۔

$ cardstream-web --ximilar-stream <session-id>

ٹیم دے ورک سپیس

سیشن تہاڈی API کنجی دے ڈیفالٹ ورک سپیس وچ محفوظ ہوندا اے۔ کوئی ہور ورک سپیس --ximilar-workspace نال دسو، تے اوتھے محفوظ سیشن دوبارہ جاری کرن ویلے اوہی id دیو۔

$ cardstream-web --ximilar-stream NEW \
    --ximilar-workspace <workspace-id>

بھروسے نال چلاؤ

ہر وکھرے کارڈ اُتے پچھان دی اک کال

لوکل اشارے (حرکت، ڈیٹیکشن، شناخت دا فلٹر) فیصلہ کردے نیں کہ پچھان دی کال کدوں واقعی بندی اے۔ ایہہ اوہ سیٹنگاں نیں جیہڑیاں ایہنوں سِدھا رکھدیاں نیں۔

حداں

نتیجے دی حد کمزور میچاں نوں اوورلے توں دور رکھدی اے؛ مشابہت دی حد فیصلہ کردی اے کہ کارڈ اوہی اے یا نواں؛ تے forget-after اودوں یادداشت صاف کر دیندا اے جدوں کارڈ کافی دیر توں غائب ہووے۔

$ cardstream-web --result-threshold 0.35

سفارش کیتا طریقہ

RF-DETR سیگمینٹیشن تے نال ONNX ایمبیڈنگ والا فلٹر: ایہو ڈیفالٹ نیں۔ ویٹس اپنی تھاں ہوون تاں خالی cardstream-web بالکل ایہو چلاؤندا اے؛ سب کجھ کھول کے لکھو تاں وی پائپ لائن اوہی اے۔

$ cardstream-web \
    --segmentor-model model/segmentation/onnx/model.onnx \
    --embed-model model/similarity/onnx/model.onnx

ایہنوں localhost اُتے ای رکھو

لوکل ایپ اُتے کوئی لاگ اِن نئیں تے اوہدے کول تہاڈی API کنجی ہوندی اے۔ --host دا ڈیفالٹ 127.0.0.1 اے؛ ایہنوں اوتھے ای رہن دیو تے پورٹ کدی LAN اُتے نہ کھولو۔

شروع ہوندیاں ای ”Model not found“

ماڈل ویٹس وکھرے ڈاؤن لوڈ ہوندے نیں، ریپو دا حصہ نئیں۔ انسٹال سکرپٹ تے Docker اِمیج اوہناں نوں آپ لے آؤندے نیں؛ خالی checkout وچ اوہناں نوں model/segmentation/ تے model/similarity/ وچ رکھنا پیندا اے، تے scripts/build-from-source.sh --models ایہہ کم تہاڈے لئی کر دیندا اے۔

دسو کیہڑی گیم وکھا رہے او

اِکو گیم دے شو وچ لوڑ نئیں کہ اینڈ پوائنٹ ہر کال اُتے گیم دا اندازہ لاوے۔ گیم دا ناں دس دیو تے کھوج اوسے گیم تک رہ جاندی اے: جواب چھیتی، غلط ایڈیشن گھٹ۔ نال --alphabet وی دیو، کیوں جے گیم دا پری فِل اینڈ پوائنٹ نوں رسم الخط آپ پچھانن توں روک دیندا اے۔

$ cardstream-web --game "Pokémon" --alphabet japanese

ffmpeg، جدوں لوڑ پوے

--listen تے --ffmpeg سسٹم دا ffmpeg بائنری چلاؤندے نیں۔ سادہ کھِچن والے سورس صرف pip والی انسٹال نال وی چلدے نیں؛ OBS توں بھیجن والا سیٹ اپ نئیں چلدا۔

ہور ڈونگھا جاؤ

ڈیفالٹ توں اگے

ماڈل بدلو یا کوڈ پڑھو: پوری پائپ لائن انسٹال ہون والا اِکو پیکج اے۔

اپنے ویٹس لیاؤ

ڈیٹیکشن تے شناخت دا فلٹر بیک اینڈ دے حساب نال چلدے نیں: ماڈل فیملی کلاس چُندی اے، تے فائل دی ایکسٹینشن رن ٹائم۔ RF-DETR یا RT-DETRv2، .onnx فائل یا transformers ڈائریکٹری۔

ماڈل بیک اینڈ ←

ماڈلاں دی لسٹ

ہر اوہ ماڈل جیہڑا cardstream لوڈ کر سکدا اے، Ximilar دا ٹرین کیتا تے ریلیزاں دے نال Apache-2.0 لائسنس دے تھلے چھاپیا: ہر اک کیہ کردا اے، کِنّی رفتار نال چلدا اے تے اوہدے اُتے کیہڑا لائسنس اے۔

ماڈلاں دی لسٹ ←

سِدھے جواب

خرچہ کِنّا اے، مشین توں باہر کیہ جاندا اے، کیہڑے کارڈ پچھاندا اے، تے اوہ دو کمانڈاں جیہڑیاں ایہنوں دوبارہ ہٹا دیندیاں نیں۔

سوال جواب پڑھو ←

README تے issues

README وچ ہر فلیگ لکھیا اے؛ بگ تے سوال issues وچ پاؤ۔

README پڑھو ←

ریلیزاں تے فائلاں

wheel، چیک سم تے انسٹال سکرپٹ، ہر ریلیز نال اک پورا سیٹ۔ نال Docker تے سورس توں بِلڈ وی۔

ڈاؤن لوڈ صفحہ ←