डाउनलोड

cardstream चालू करें

macOS और Linux पर एक कमांड; ज़्यादा कंट्रोल चाहिए तो रिलीज़ का wheel, Dockerfile और सोर्स बिल्ड। macOS arm64, Linux amd64 और Windows amd64, तीनों एक ही pure-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 — latest की जगह कोई रिलीज़ टैग पिन करें, जैसे v0.5.0
CARDSTREAM_HOME — इंस्टॉल का मूल फ़ोल्डर, जिसमें venv और मॉडल रहते हैं (डिफ़ॉल्ट ~/.cardstream)
INSTALL_DIR — cardstream-web / cardstream-client के शिम कहां जाएं (डिफ़ॉल्ट ~/.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 के साथ मिलते हैं। एक pure-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 के शिम, सब अपने-आप।	`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 या इंटरनेट पर न खोलें।

सोर्स

सोर्स से बिल्ड करें

एक चेकआउट, एक स्क्रिप्ट, और पहली जांच के तौर पर ऑफ़लाइन टेस्ट सूट। --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

अपना तरीका चुनें

इसे कंटेनर में चलाएं

सोर्स से बिल्ड करें

आगे क्या

इंस्टॉल करें और चलाएं →

इसे अपना शो दें →

भरोसे के साथ चलाएं →

अपडेट या अनइंस्टॉल →