cardstream
ڈاؤن لوڈ

cardstream چالو کرو

macOS تے Linux اُتے اک کمانڈ؛ تے جے بہتا کنٹرول چاہیدا ہووے تاں ریلیز دا wheel، Dockerfile تے سورس توں بِلڈ۔ macOS arm64، Linux amd64 تے Windows amd64 تِنّے اوسے اِکو خالص Python ریلیز نال چلدے نیں۔

انسٹال سکرپٹ

اک کمانڈ نال انسٹال

~/.cardstream وچ virtualenv بناؤندا اے، ریلیز دے wheel نوں چیک سم نال پرکھدا اے، ماڈل ویٹس لیاؤندا اے تے cardstream-web تے cardstream-client تہاڈے PATH اُتے رکھ دیندا اے۔ جے تہاڈے کول uv ہووے تاں اوہی ورتدا اے۔

$ curl -fsSL https://raw.githubusercontent.com/Ximilar-com/cardstream/main/scripts/install.sh | sh
$ export XIMILAR_API_KEY=your-key
$ cardstream-web
# → http://127.0.0.1:8001 (کارڈ کیمرے اگے کرو)

سیٹنگاں، جے لوڑ پوے

  • CARDSTREAM_VERSION — سب توں نویں دی تھاں کوئی خاص ریلیز ٹیگ پکا کرو، مثلاً v0.5.0
  • CARDSTREAM_HOME — انسٹال دی جڑ، جتھے venv تے ماڈل رہندے نیں (ڈیفالٹ ~/.cardstream)
  • INSTALL_DIR — cardstream-web / cardstream-client دے shim کتھے رکھے جان (ڈیفالٹ ~/.local/bin)
  • CARDSTREAM_MODELS_BASE_URL — ہر ماڈل دے ویٹس والے tarball لئی کوئی ہور ہوسٹ
  • CARDSTREAM_MODEL_ARCHIVES — اوتھوں کیہڑے tarball لیاؤنے نیں (سپیس نال وکھرے کیتے)
  • CARDSTREAM_EXTRAS — انسٹال ہون والے pip extras (ڈیفالٹ client,onnx)
  • CARDSTREAM_TRACKER_URL — اختیاری vitTracker .onnx (ڈیفالٹ: OpenCV zoo)
تصدیق

انسٹال دی تصدیق کرو

سکرپٹ کجھ وی انسٹال کرن توں پہلاں wheel نوں ریلیز دی SHA256SUMS فائل نال پرکھدا اے۔ بعد وچ اک فلیگ دس دیندا اے کہ تہاڈی مشین اُتے کیہ اے:

$ cardstream-web --version
cardstream 0.5.0

فائلاں آپ ڈاؤن لوڈ کیتیاں نیں؟ اوہناں نوں اونج ای پرکھو جیویں سکرپٹ پرکھدا اے: shasum -a 256 -c SHA256SUMS۔

ہتھیں ڈاؤن لوڈ

سِدھا ریلیز توں

پیکج PyPI اُتے اے، تے ہر GitHub ریلیز وچ اوہی wheel تے sdist اک SHA256SUMS فائل دے نال ہوندے نیں۔ اِکو خالص Python wheel ہر پلیٹ فارم اُتے چلدا اے:

$ pip install 'cardstream[client,onnx]'

Windows

انسٹال سکرپٹ صرف POSIX لئی اے؛ Windows اُتے PyPI توں انسٹال کرو، ماڈلاں والی ریلیز توں ہر ماڈل دے ویٹس والے tarball کھولو، تے فلیگاں نوں اوہناں ول کر دیو:

> py -3.11 -m venv cardstream-env
> cardstream-env\Scripts\activate
> pip install 'cardstream[client,onnx]'
> set XIMILAR_API_KEY=your-key
> cardstream-web --segmentor-model models\segmentation_model\onnx\model.onnx ^
    --embed-model models\similarity_model\onnx\model.onnx
موازنہ

اپنا طریقہ چُنو

طریقہ کدوں ودھیا پہلی تصدیق
انسٹال سکرپٹ تہانوں localhost اُتے سب توں چھیتی سیٹ اپ چاہیدا اے: venv، ماڈل ویٹس تے PATH والے shim، سب آپ ای ہو جاندا اے۔ cardstream-web --version
Docker صاف ہوسٹ چاہیدا ہووے، یا اِنکوڈر دے نیڑے کسے مشین اُتے OBS دی بھیجی سٹریم لینی ہووے۔ curl -s http://127.0.0.1:8001/mode
سورس توں بِلڈ تسیں کوڈ بدل رہے او۔ pytest -q tests/core/test_engine.py
Docker

کنٹینر وچ چلاؤ

اِمیج پہلی واری چلن اُتے ماڈل ویٹس اک والیوم وچ لے آؤندا اے تے ویب کلائنٹ شروع کر دیندا اے۔ ایہنوں ریپو دی Dockerfile توں بِلڈ کرو:

$ git clone https://github.com/Ximilar-com/cardstream && cd cardstream
$ docker build -t cardstream .
$ docker run --rm -e XIMILAR_API_KEY -p 127.0.0.1:8001:8001 \
    -v cardstream-models:/models cardstream

کنٹینر اندروں 0.0.0.0 اُتے بائنڈ ہوندا اے، ایس لئی پورٹ صرف 127.0.0.1 اُتے کھولو، جیویں اُتے وکھایا اے۔ ایپ اُتے کوئی لاگ اِن نئیں تے اوہدے کول تہاڈی Ximilar API کنجی ہوندی اے؛ ایہنوں کدی LAN یا انٹرنیٹ اُتے نہ کھولو۔

سورس

سورس توں بِلڈ

اک checkout، اک سکرپٹ، تے پہلی تصدیق لئی آف لائن ٹیسٹ سوٹ۔ --models نال ویٹس وی آ جاندے نیں۔

$ git clone https://github.com/Ximilar-com/cardstream && cd cardstream
$ ./scripts/build-from-source.sh --models
$ source .venv/bin/activate
$ cardstream-web --version