คำถามที่พบบ่อย

ต้องมีอะไรบ้างถึงจะรันได้?

เครื่องที่มี Python 3.11 ขึ้นไป แค่นั้นเกือบจะพอแล้ว macOS arm64, Linux amd64 และ Windows amd64 ครอบคลุมด้วยรีลีส Python ล้วนตัวเดียวกัน ไม่ต้องมี GPU ไบนารี ffmpeg ของระบบจำเป็นเฉพาะกับแหล่งสัญญาณแบบดึงและแบบรอรับ (RTSP, RTMP, SRT) เท่านั้น เว็บแคม ไฟล์ หรือ UI ในเบราว์เซอร์ไม่ต้องใช้

สคริปต์ติดตั้งวางไฟล์ไว้ที่ไหน?

สองที่ ~/.cardstream คือรูทของการติดตั้ง มี virtualenv ใน venv/ และน้ำหนักโมเดลใน models/ ส่วนคำสั่งทั้งสอง cardstream-web และ cardstream-client เป็นสคริปต์เรียกใช้เล็กๆ ที่เขียนลง ~/.local/bin มันจะ exec ไบนารีใน venv พร้อมพาธโมเดลที่ใส่ไว้ให้แล้ว ดังนั้นแฟล็กใดที่คุณส่งไปจะมีผลเหนือกว่าเสมอ ทั้งสองตำแหน่งย้ายได้ด้วย CARDSTREAM_HOME และ INSTALL_DIR ที่อื่นบนเครื่องไม่ถูกแตะเลย โดยเฉพาะสคริปต์จะไม่แก้ shell profile ของคุณเด็ดขาด: ถ้า ~/.local/bin ไม่อยู่ใน PATH มันจะพิมพ์ข้อความแจ้ง แล้วปล่อยให้คุณเปลี่ยนเอง

อัปเดตเป็นเวอร์ชันใหม่ยังไง?

รันคำสั่งบรรทัดเดียวกันอีกครั้ง มันจะติดตั้งรีลีสปัจจุบันลง virtualenv ที่มีอยู่ และเขียนสคริปต์เรียกใช้ใหม่ น้ำหนักโมเดลที่อยู่ใน ~/.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 และน้ำหนักโมเดล คำสั่งที่สองลบสคริปต์เรียกใช้ทั้งสอง ไม่มีอะไรต้องเก็บกวาดอีก ไม่มี daemon ไม่มีรายการเริ่มต้นตอนล็อกอิน ไม่มีแพ็กเกจระบบ

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

ถ้าคุณติดตั้งโดยตั้ง CARDSTREAM_HOME หรือ INSTALL_DIR ไว้ ให้ลบพาธเหล่านั้นแทน และใช้ sudo หากคุณวางสคริปต์เรียกใช้ไว้ในไดเรกทอรีของระบบ สิ่งที่คุณเพิ่มเองด้วยมือยังคงต้องย้อนกลับเอง: บรรทัด PATH ใน shell profile คำสั่ง export XIMILAR_API_KEY และโฟลเดอร์ใดๆ ที่คุณส่งให้ --store-images แอปไม่เขียนอะไรอื่นไว้ใต้โฮมไดเรกทอรีของคุณ ตรวจสอบว่าหายไปแล้วด้วย command -v cardstream-web ใน shell ใหม่ เพราะ shell เก่าจะแคชผลค้นหาไว้จนกว่าคุณจะรัน hash -r

ต้องมี GPU ไหม?

ไม่ต้อง น้ำหนักโมเดลที่มาพร้อมแพ็กเกจเป็นไฟล์ ONNX ที่ปรับขนาดมาสำหรับ CPU และทุกอย่างที่เอนจินในเครื่องทำ ทั้งเกตตรวจจับการเคลื่อนไหว ตัวจำกัดความถี่การตรวจจับ และเอ็มเบดดิงที่ตอบว่า "ใบเดิมหรือใบใหม่?" ล้วนรันบนโปรเซสเซอร์ที่คุณมีอยู่แล้ว GPU เป็นทางเลือกสำหรับน้ำหนักโมเดลความแม่นยำสูงของคุณเอง ไม่ใช่ข้อบังคับสำหรับค่าเริ่มต้น

ใช้กับ Whatnot หรือ Fanatics Live ได้ไหม?

ได้ แต่ไม่ใช่ด้วยการเชื่อมต่อกับมาร์เก็ตเพลส มันต่อเข้ากับวิดีโอที่คุณผลิตอยู่แล้ว ไม่ว่าจะเป็นกล้องเสมือนของ OBS เอาต์พุต RTMP หรือ SRT ตัวที่สองข้างตัวที่ส่งไปแพลตฟอร์ม การดึง RTSP จากเอนโค้ดเดอร์ หรือแค่กล้องของมันเองที่หันไปที่โต๊ะเดียวกัน คู่มือการขายไลฟ์สดพาเดินทั้งสี่เส้นทางตั้งแต่ต้นจนจบ

จริงๆ แล้วอะไรออกจากเครื่องของฉันบ้าง?

ในโหมดไคลเอนต์ มีแค่ภาพตัด JPEG หนึ่งภาพต่อการ์ดที่ต่างกันแต่ละใบ ไม่ใช่สตรีม ไม่ใช่เฟรมรอบๆ ไม่ใช่ส่วนที่เหลือของโต๊ะ ทุกการตัดสินใจว่าจะส่งอะไรหรือไม่เกิดขึ้นในเครื่องก่อน ดังนั้นวิดีโอหนึ่งชั่วโมงที่คุณโชว์การ์ดหนึ่งร้อยใบ ก็คือคำขอเล็กๆ หนึ่งร้อยครั้ง ข้อยกเว้นเดียวคือสิ่งที่คุณเลือกเปิดเอง: เมื่อใช้ --ximilar-stream ประวัติของรายการ (แถวข้อความหนึ่งแถวต่อการ์ดหนึ่งใบ พร้อมภาพตัดที่ใช้ระบุ) จะถูกบันทึกลงเซสชันในบัญชี Ximilar ของคุณเองด้วย ปิดไว้เป็นค่าเริ่มต้น และ --no-ximilar-stream-images จะจำกัดไว้แค่ข้อความ

ย้อนดูรายการทีหลังได้ไหม?

ได้ ถ้าคุณบันทึกไว้ เริ่มด้วย --ximilar-stream NEW แล้วการ์ดทุกใบที่อยู่ในประวัติ พร้อมราคา เวลาบนสตรีม และภาพตัดที่ใช้ระบุ จะถูกส่งไปยังเซสชันในบัญชี Ximilar ของคุณระหว่างที่รายการดำเนินอยู่ หลังจากนั้นเปิดส่วน Cardstream ของแอป Ximilar: มูลค่าของรายการ สินค้าที่มีมูลค่าสูงสุดและชุดอันดับต้นๆ การ์ดทุกใบพร้อมภาพ ทำเครื่องหมายว่าใบไหนขายแล้ว และแก้ผลที่จับคู่ผิด รีสตาร์ตกลางรายการ? ส่ง id ของเซสชันแทน NEW แล้วรายการจะดำเนินต่อ แม้เซสชันจะถูกปิดไปแล้วก็ตาม การบันทึกลงเวิร์กสเปซของทีมใช้ --ximilar-workspace ดูรายละเอียดทั้งหมด

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

รันบน LAN เพื่อให้เครื่องอื่นเปิด UI ได้ไหม?

อย่าทำ เว็บ UI ไม่มีการยืนยันตัวตนและถือคีย์ API ของคุณอยู่ มันจึงควรอยู่บน 127.0.0.1 เท่านั้น คอนเทนเนอร์ bind กับ 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