Soalan lazim

Apa yang saya perlukan untuk menjalankannya?

Mesin dengan Python 3.11 atau lebih baharu, dan itu hampir semuanya. macOS arm64, Linux amd64 dan Windows amd64 semuanya disokong oleh keluaran Python tulen yang sama, tanpa memerlukan GPU. Binari ffmpeg sistem hanya diperlukan untuk sumber tarik dan dengar (RTSP, RTMP, SRT); kamera web, fail atau UI pelayar tidak memerlukannya.

Di mana skrip pemasangan meletakkan fail?

Di dua tempat. ~/.cardstream ialah direktori akar pemasangan: virtualenv dalam venv/ dan pemberat model dalam models/. Dua arahan, cardstream-web dan cardstream-client, ialah shim kecil yang ditulis ke dalam ~/.local/bin; shim ini menjalankan binari venv dengan laluan model yang sudah diisi, jadi apa-apa bendera yang anda berikan akan diutamakan. Kedua-dua lokasi boleh dialihkan dengan CARDSTREAM_HOME dan INSTALL_DIR. Tiada apa-apa lagi pada mesin yang disentuh. Khususnya, skrip ini tidak pernah menyunting profil shell anda: jika ~/.local/bin tiada dalam PATH anda, ia mencetak nota dan menyerahkan perubahan itu kepada anda.

Bagaimanakah cara mengemas kini kepada versi baharu?

Jalankan semula arahan satu baris yang sama. Ia memasang keluaran semasa ke dalam virtualenv sedia ada dan menulis semula shim. Pemberat yang sudah ada dalam ~/.cardstream/models tidak diusik (ia hanya dimuat turun jika tiada), jadi kemas kini hanyalah muat turun kecil, bukan satu lagi suku gigabait. Untuk memasang keluaran tertentu dan bukan yang terkini, tetapkan CARDSTREAM_VERSION.

# arahan satu baris yang sama; /install.sh mengubah hala ke skrip pada main
$ curl -fsSL https://cardstream.ai/install.sh | sh
$ curl -fsSL https://cardstream.ai/install.sh | CARDSTREAM_VERSION=v0.5.2 sh
$ cardstream-web --version

Bagaimanakah cara menyahpasangnya?

Dua arahan. Yang pertama membuang virtualenv dan pemberat model, yang kedua membuang dua shim itu. Tiada apa-apa lagi yang perlu dibersihkan: tiada daemon, tiada item log masuk, tiada pakej sistem.

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

Jika anda memasang dengan CARDSTREAM_HOME atau INSTALL_DIR ditetapkan, buang laluan tersebut sebaliknya, dan gunakan sudo jika anda meletakkan shim dalam direktori sistem. Apa-apa yang anda tambah sendiri masih perlu anda buang sendiri: baris PATH dalam profil shell anda, eksport XIMILAR_API_KEY, dan mana-mana folder yang anda berikan kepada --store-images. Aplikasi ini tidak menulis apa-apa lagi di bawah direktori rumah anda. Pastikan ia sudah hilang dengan command -v cardstream-web dalam shell baharu; shell lama menyimpan carian itu dalam cache sehingga anda menjalankan hash -r.

Adakah saya memerlukan GPU?

Tidak. Pemberat yang disertakan ialah eksport ONNX yang bersaiz untuk CPU, dan semua yang dilakukan oleh enjin setempat (penapis gerakan, pendikit pengesanan, embedding yang menjawab “kad yang sama atau kad baharu?”) berjalan pada pemproses yang sudah anda miliki. GPU ialah pilihan untuk pemberat anda sendiri yang lebih tepat, bukan keperluan bagi tetapan lalai.

Adakah ia berfungsi dengan Whatnot atau Fanatics Live?

Ya, tetapi bukan dengan menyambung ke platform jualan itu. Ia mengambil video yang sudah anda hasilkan: kamera maya OBS, output RTMP atau SRT kedua di sebelah output yang menyuap platform, tarikan RTSP daripada pengekod, atau hanya kameranya sendiri yang dihalakan ke tikar yang sama. Panduan jualan secara live menerangkan keempat-empat cara itu dari awal hingga akhir.

Apa sebenarnya yang keluar dari mesin saya?

Dalam mod sisi klien, satu keratan JPEG bagi setiap kad yang berbeza. Bukan strim, bukan bingkai di sekelilingnya, bukan bahagian lain tikar. Setiap keputusan tentang sama ada hendak menghantar apa-apa dibuat secara setempat terlebih dahulu, jadi video sejam yang menunjukkan seratus kad bermaksud seratus permintaan kecil. Satu-satunya pengecualian perlu anda hidupkan sendiri: dengan --ximilar-stream, sejarah sesi live (satu baris teks bagi setiap kad serta keratan yang digunakan untuk mengecamnya) turut disimpan ke satu sesi dalam akaun Ximilar anda sendiri. Dimatikan secara lalai, dan --no-ximilar-stream-images mengehadkannya kepada teks.

Bolehkah saya menyemak sesi live selepas itu?

Ya, jika anda menyimpannya. Mulakan dengan --ximilar-stream NEW dan setiap kad yang disenaraikan dalam sejarah (bersama harganya, tempoh dalam strim dan keratan yang digunakan untuk mengecamnya) dihantar ke satu sesi dalam akaun Ximilar anda sepanjang sesi live berjalan. Selepas itu, buka bahagian Cards Cloud dalam aplikasi Ximilar: nilai sesi live, produk paling bernilai dan set teratas, setiap kad bersama gambarnya; tandakan yang terjual dan betulkan padanan yang salah. Terpaksa mula semula di tengah sesi live? Berikan ID sesi menggantikan NEW dan ia diteruskan, walaupun sesi itu sudah ditutup. Untuk menyimpan ke dalam ruang kerja pasukan, gunakan --ximilar-workspace. Butiran lanjut.

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

Bolehkah saya menjalankannya pada LAN supaya mesin lain boleh membuka UI?

Jangan. UI web tidak memerlukan pengesahan dan menyimpan kunci API anda, jadi tempatnya ialah 127.0.0.1 dan tidak di tempat lain. Bekas ini mengikat 0.0.0.0 secara dalaman, dan sebab itulah docker run yang didokumenkan menerbitkan port itu kepada 127.0.0.1 sahaja. Jika anda benar-benar memerlukannya dari mesin lain, letakkan terowong anda sendiri yang memerlukan pengesahan di hadapannya dan bukannya membuka port itu.

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