التنزيل

شغّل cardstream عندك

أمر واحد على macOS وLinux، وملف wheel للإصدار وDockerfile وبناء من المصدر حين تريد تحكمًا أكبر. الإصدار نفسه المكتوب بلغة Python الخالصة يغطي macOS arm64 وLinux amd64 وWindows amd64.

سكربت التثبيت

ثبّته بأمر واحد

ينشئ virtualenv في ~/.cardstream، ويتحقق من ملف 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 — المكان الذي توضع فيه ملفات shim للأمرين cardstream-web / cardstream-client (الافتراضي ~/.local/bin)
CARDSTREAM_MODELS_BASE_URL — خادم بديل لملفات tarball التي تحمل أوزان كل نموذج
CARDSTREAM_MODEL_ARCHIVES — ملفات tarball التي تُجلب من هناك (تفصل بينها مسافات)
CARDSTREAM_EXTRAS — إضافات pip التي تُثبَّت (الافتراضي 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. ملف wheel واحد بلغة Python الخالصة يغطي كل المنصات:

$ 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 وأوزان النماذج وملفات shim على 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 الخاص بك، فلا تكشفه أبدًا للشبكة المحلية ولا للإنترنت.

المصدر

البناء من المصدر

نسخة من المستودع، وسكربت واحد، ومجموعة الاختبارات التي تعمل بلا اتصال لتكون أول تحقق لك. والخيار --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

اختر طريقتك

شغّله في حاوية

البناء من المصدر

الخطوات التالية

التثبيت والتشغيل ←

زوّده بعرضك ←

شغّله بثقة ←

التحديث أو الإزالة ←