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 |
کنٹینر وچ چلاؤ
اِمیج پہلی واری چلن اُتے ماڈل ویٹس اک والیوم وچ لے آؤندا اے تے ویب کلائنٹ شروع کر دیندا اے۔ ایہنوں ریپو دی 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
اگلے قدم
انسٹال کرو تے چلاؤ ←
تہاڈی کنجی، پہلی واری چلاؤنا، تے کیہ ویکھنا اے۔
ایہنوں اپنا شو دیو ←
ویب کیم، RTSP توں کھِچنا، OBS دا سِدھا بھیجنا۔
بھروسے نال چلاؤ ←
حداں، سفارش کیتا طریقہ، تے localhost اُتے ای رہنا۔
اپڈیٹ یا اَن انسٹال ←
سکرپٹ چیزاں کتھے رکھدا اے، تے اوہ دو کمانڈاں جیہڑیاں سب واپس کر دیندیاں نیں۔