ডাউনলোড

cardstream চালু করুন

macOS ও Linux‑এ একটি কমান্ড; আরও নিয়ন্ত্রণ চাইলে রিলিজ wheel, একটি Dockerfile আর সোর্স থেকে বিল্ড। একই pure-Python রিলিজে macOS arm64, Linux amd64 ও Windows amd64 সবই চলে।

ইনস্টল স্ক্রিপ্ট

এক কমান্ডে ইনস্টল

~/.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 — মডেলপ্রতি ওয়েট টারবলের বিকল্প হোস্ট
CARDSTREAM_MODEL_ARCHIVES — সেখান থেকে কোন কোন টারবল নামাতে হবে (স্পেস দিয়ে আলাদা করা)
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 থেকে ইনস্টল করুন, মডেল রিলিজ থেকে মডেলপ্রতি ওয়েট টারবলগুলো খুলে নিন, আর ফ্ল্যাগগুলো সেগুলোর দিকে দেখিয়ে দিন:

> 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 বা ইন্টারনেটে খুলে দেবেন না।

সোর্স

সোর্স থেকে বিল্ড

একটি চেকআউট, একটি স্ক্রিপ্ট, আর প্রথম যাচাই হিসেবে অফলাইন টেস্ট স্যুট। --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

উপায় বেছে নিন

কনটেইনারে চালান

সোর্স থেকে বিল্ড

পরের ধাপ

ইনস্টল ও চালু করা →

নিজের শো এতে পাঠান →

নিশ্চিন্তে চালান →

আপডেট বা আনইনস্টল →