সচরাচর জিজ্ঞাসা

চালাতে কী কী লাগে?

Python 3.11 বা তার পরের ভার্সনসহ একটি কম্পিউটার, মোটামুটি এটুকুই। একই pure-Python রিলিজে macOS arm64, Linux amd64 ও Windows amd64 সবই চলে, GPU লাগে না। সিস্টেমের ffmpeg বাইনারি লাগে শুধু পুল ও লিসেন সোর্সের জন্য (RTSP, RTMP, SRT); ওয়েবক্যাম, ফাইল বা ব্রাউজার UI‑এর জন্য লাগে না।

ইনস্টল স্ক্রিপ্ট কোথায় কী রাখে?

দুটি জায়গায়। ~/.cardstream হলো ইনস্টলের মূল ফোল্ডার: venv/-এ একটি virtualenv আর models/-এ মডেল ওয়েট। দুটি কমান্ড, cardstream-web ও cardstream-client, আসলে ~/.local/bin-এ লেখা ছোট দুটি লঞ্চার স্ক্রিপ্ট (shim); এগুলো মডেলের পাথ আগে থেকে বসিয়ে venv‑এর বাইনারি চালায়, তাই আপনি যে ফ্ল্যাগই দিন, সেটিই প্রাধান্য পায়। দুটি জায়গাই CARDSTREAM_HOME ও INSTALL_DIR দিয়ে সরানো যায়। কম্পিউটারের আর কিছুতেই হাত পড়ে না; বিশেষ করে স্ক্রিপ্ট কখনো আপনার শেল প্রোফাইল বদলায় না: ~/.local/bin আপনার PATH-এ না থাকলে এটি শুধু জানিয়ে দেয়, বদলটা আপনার হাতেই ছেড়ে রাখে।

নতুন ভার্সনে কীভাবে আপডেট করব?

একই এক লাইনের কমান্ডটি আবার চালান। এটি আগের virtualenv‑এই চলতি রিলিজ ইনস্টল করে আর shim দুটি নতুন করে লেখে। ~/.cardstream/models-এ আগে থেকে থাকা ওয়েটে হাত দেয় না (ওয়েট নামানো হয় শুধু না থাকলে), তাই আপডেট মানে ছোট একটি ডাউনলোড, আবার সিকি গিগাবাইট নয়। সর্বশেষটির বদলে নির্দিষ্ট কোনো রিলিজ চাইলে CARDSTREAM_VERSION সেট করুন।

# একই এক লাইনের কমান্ড; /install.sh রিডাইরেক্ট করে main-এর স্ক্রিপ্টে
$ curl -fsSL https://cardstream.ai/install.sh | sh
$ curl -fsSL https://cardstream.ai/install.sh | CARDSTREAM_VERSION=v0.5.0 sh
$ cardstream-web --version

কীভাবে আনইনস্টল করব?

দুটি কমান্ডে। প্রথমটি virtualenv আর মডেল ওয়েট মুছে দেয়, দ্বিতীয়টি shim দুটি। আর কিছু পরিষ্কার করার নেই: কোনো ডিমন নেই, লগইন আইটেম নেই, সিস্টেম প্যাকেজও নেই।

$ rm -rf ~/.cardstream # venv/ + models/
$ rm -f ~/.local/bin/cardstream-web ~/.local/bin/cardstream-client

CARDSTREAM_HOME বা INSTALL_DIR সেট করে ইনস্টল করে থাকলে তার বদলে ওই পাথগুলো মুছুন, আর shim কোনো সিস্টেম ডিরেক্টরিতে বসিয়ে থাকলে sudo ব্যবহার করুন। নিজের হাতে যা যোগ করেছিলেন, তা সরানোর কাজটিও আপনার: শেল প্রোফাইলের PATH লাইন, XIMILAR_API_KEY এক্সপোর্ট, আর --store-images ফ্ল্যাগে দেওয়া যেকোনো ফোল্ডার। অ্যাপ আপনার হোম ডিরেক্টরিতে আর কিছু লেখে না। নতুন একটি শেলে command -v cardstream-web চালিয়ে দেখে নিন, সত্যিই মুছেছে কি না; পুরোনো শেল hash -r না চালানো পর্যন্ত আগের খোঁজ ক্যাশে রেখে দেয়।

GPU কি লাগবে?

না। সঙ্গে আসা ওয়েটগুলো CPU‑এর উপযোগী করে বানানো ONNX এক্সপোর্ট, আর লোকাল ইঞ্জিন যা যা করে (মোশন ফিল্টার, ডিটেকশন থ্রটল, “একই কার্ড, নাকি নতুন?” প্রশ্নের উত্তর দেওয়া এমবেডিং), সবই চলে আপনার হাতে থাকা প্রসেসরে। নিজের বেশি নির্ভুল ওয়েট চালাতে চাইলে GPU একটি বিকল্প, ডিফল্টের জন্য কখনোই শর্ত নয়।

Whatnot বা Fanatics Live‑এর সঙ্গে কি চলে?

হ্যাঁ, তবে মার্কেটপ্লেসের ভেতরে ঢুকে নয়; আপনি যে ভিডিও আগে থেকেই তৈরি করছেন, এটি সেখান থেকেই একটি কপি নেয়। OBS‑এর ভার্চুয়াল ক্যামেরা, প্ল্যাটফর্মে যাওয়া আউটপুটের পাশে দ্বিতীয় একটি RTMP বা SRT আউটপুট, এনকোডার থেকে RTSP পুল, কিংবা একই ম্যাটের দিকে তাক করা এর নিজের একটি ক্যামেরা। লাইভে বিক্রির গাইডে চারটি উপায়ই শুরু থেকে শেষ পর্যন্ত দেখানো আছে।

আমার কম্পিউটার ছেড়ে আসলে কী বাইরে যায়?

ক্লায়েন্ট-সাইড মোডে আলাদা প্রতিটি কার্ডে একটি JPEG ক্রপ; স্ট্রিম নয়, তার আশপাশের ফ্রেম নয়, ম্যাটের বাকি অংশও নয়। কিছু পাঠানো হবে কি না, সেই প্রতিটি সিদ্ধান্ত আগে লোকালভাবেই হয়; তাই যে এক ঘণ্টার ভিডিওতে আপনি এক শ কার্ড দেখান, তা মানে এক শটি ছোট রিকোয়েস্ট। একটিই ব্যতিক্রম আছে, আর সেটি চালু করা আপনার হাতে: --ximilar-stream দিলে শোয়ের ইতিহাসও (প্রতি কার্ডে একটি টেক্সট সারি আর যে ক্রপ থেকে সেটি শনাক্ত হয়েছিল) আপনার নিজের Ximilar অ্যাকাউন্টের একটি সেশনে সেভ হয়। ডিফল্টভাবে বন্ধ, আর --no-ximilar-stream-images দিলে শুধু টেক্সটই যায়।

শো শেষে কি পর্যালোচনা করা যায়?

হ্যাঁ, যদি সেভ করেন। --ximilar-stream NEW দিয়ে শুরু করুন; ইতিহাসে থাকা প্রতিটি কার্ড (দাম, স্ট্রিমে থাকার সময় আর যে ক্রপ থেকে সেটি শনাক্ত হয়েছিল, সবসহ) শো চলতে চলতেই আপনার Ximilar অ্যাকাউন্টের একটি সেশনে চলে যায়। পরে Ximilar অ্যাপের Cardstream অংশ খুলুন: শোয়ের মোট মূল্য, সবচেয়ে দামি পণ্য ও শীর্ষ সেট, ছবিসহ প্রতিটি কার্ড; কী বিক্রি হলো চিহ্নিত করুন আর ভুল ম্যাচ ঠিক করুন। শোয়ের মাঝখানে রিস্টার্ট করতে হলো? NEW-এর জায়গায় সেশন id দিন, সেশন বন্ধ হয়ে গিয়ে থাকলেও শো চলতে থাকবে। টিমের ওয়ার্কস্পেসে সেভ করতে লাগে --ximilar-workspace। বিস্তারিত এখানে।

$ cardstream-web --price-stats --ximilar-stream NEW

LAN‑এ চালিয়ে অন্য কম্পিউটার থেকে UI খোলা যাবে?

না, করবেন না। ওয়েব UI‑তে কোনো লগইন নেই, আর এতে আপনার API কী থাকে; তাই এর জায়গা 127.0.0.1, আর কোথাও নয়। কনটেইনার ভেতরে 0.0.0.0-তে বাইন্ড করে, সে কারণেই ডকসে দেওয়া docker run পোর্টটি শুধু 127.0.0.1-এ পাবলিশ করে। অন্য কম্পিউটার থেকে সত্যিই দরকার হলে পোর্ট খুলে না দিয়ে সামনে নিজের একটি অথেনটিকেটেড টানেল বসান।

$ docker run --rm -e XIMILAR_API_KEY -p 127.0.0.1:8001:8001 \
    -v cardstream-models:/models cardstream