ڈاؤن لوڈ

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 — ہر ماڈل کے ویٹس والے tarballs کے لیے متبادل ہوسٹ
CARDSTREAM_MODEL_ARCHIVES — وہاں سے کون سے tarballs لانے ہیں (اسپیس سے الگ کیے ہوئے)
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 سے انسٹال کریں، ماڈلز والی ریلیز سے ہر ماڈل کے ویٹس کے tarballs کھولیں، اور فلیگز کا رخ ان کی طرف کر دیں:

> 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

cardstream کو چالو کریں

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

سیٹنگز، اگر ضرورت پڑے

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

سیدھا ریلیز سے

Windows

اپنا طریقہ چنیں

کنٹینر میں چلائیں

سورس سے بلڈ

اگلے مراحل

انسٹال کریں اور چلائیں ←

اسے اپنا شو دیں ←

بے فکر ہو کر چلائیں ←

اپ ڈیٹ یا اَن انسٹال ←