Pertanyaan yang sering diajukan

Apa saja yang kubutuhkan untuk menjalankannya?

Komputer dengan Python 3.11 atau lebih baru, dan kurang lebih itu saja. macOS arm64, Linux amd64, dan Windows amd64 semuanya tercakup oleh rilis pure-Python yang sama, tanpa perlu GPU. Binary ffmpeg sistem hanya dibutuhkan untuk sumber tarik dan listen (RTSP, RTMP, SRT). Webcam, file, atau antarmuka browser tidak membutuhkannya.

Di mana skrip instalasi menaruh semuanya?

Di dua tempat. ~/.cardstream adalah direktori instalasinya: sebuah virtualenv di venv/ dan bobot model di models/. Kedua perintahnya, cardstream-web dan cardstream-client, adalah shim kecil yang ditulis ke ~/.local/bin. Shim itu menjalankan binary di dalam venv dengan path model yang sudah terisi, jadi flag apa pun yang kamu berikan tetap menang. Kedua lokasi berpindah mengikuti CARDSTREAM_HOME dan INSTALL_DIR. Tidak ada hal lain di komputer yang disentuh. Skrip ini khususnya tidak pernah mengubah profil shell-mu: kalau ~/.local/bin belum ada di PATH, ia mencetak catatan dan menyerahkan perubahannya kepadamu.

Bagaimana cara memperbarui ke versi baru?

Jalankan lagi perintah satu baris yang sama. Ia memasang rilis terkini ke virtualenv yang sudah ada dan menulis ulang shim-nya. Bobot yang sudah ada di ~/.cardstream/models dibiarkan apa adanya, karena hanya diunduh kalau belum ada. Jadi pembaruan hanyalah unduhan kecil, bukan seperempat gigabita lagi. Untuk memasang rilis tertentu alih-alih yang terbaru, setel CARDSTREAM_VERSION.

# perintah satu baris yang sama; /install.sh dialihkan ke skrip di 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

Bagaimana cara menghapusnya?

Dua perintah. Yang pertama menghapus virtualenv dan bobot model, yang kedua menghapus kedua shim. Tidak ada lagi yang perlu dibersihkan: tidak ada daemon, tidak ada item login, tidak ada paket sistem.

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

Kalau kamu menginstal dengan CARDSTREAM_HOME atau INSTALL_DIR yang disetel, hapus path itu sebagai gantinya, dan pakai sudo kalau shim-nya kamu arahkan ke direktori sistem. Apa pun yang kamu tambahkan sendiri tetap menjadi urusanmu untuk dibatalkan: baris PATH di profil shell, ekspor XIMILAR_API_KEY, dan folder mana pun yang kamu berikan ke --store-images. Aplikasi ini tidak menulis apa-apa lagi di direktori home-mu. Pastikan sudah terhapus dengan command -v cardstream-web di shell baru. Shell yang lama masih menyimpan hasil pencariannya di cache sampai kamu menjalankan hash -r.

Apakah aku butuh GPU?

Tidak. Bobot bawaannya adalah ekspor ONNX yang ukurannya disesuaikan untuk CPU, dan semua yang dikerjakan mesin lokal berjalan di prosesor yang sudah kamu punya: gerbang gerakan, pembatas deteksi, dan embedding yang menjawab “kartu yang sama atau kartu baru?”. GPU adalah pilihan untuk bobotmu sendiri yang lebih akurat, bukan syarat untuk bawaannya.

Apakah bisa dipakai dengan Whatnot atau Fanatics Live?

Bisa, tetapi bukan dengan menyambung ke marketplace-nya. Ia menyadap video yang memang sudah kamu hasilkan: kamera virtual OBS, output RTMP atau SRT kedua di samping output yang menuju platform, tarikan RTSP dari encoder, atau cukup kameranya sendiri yang diarahkan ke alas yang sama. Panduan jualan live membahas keempat rute itu dari awal sampai akhir.

Apa sebenarnya yang keluar dari komputerku?

Dalam mode sisi klien, satu potongan gambar JPEG per kartu berbeda. Bukan siarannya, bukan frame di sekitarnya, bukan sisa alasnya. Setiap keputusan tentang perlu atau tidaknya mengirim sesuatu dibuat secara lokal lebih dulu, jadi satu jam video dengan seratus kartu yang kamu tunjukkan berarti seratus permintaan kecil. Satu-satunya pengecualian kamu sendiri yang menyalakan: dengan --ximilar-stream, riwayat live-nya juga disimpan ke sebuah sesi di akun Ximilar-mu sendiri, berupa satu baris teks per kartu ditambah potongan gambar yang dipakai untuk mengidentifikasinya. Nonaktif secara bawaan, dan dengan --no-ximilar-stream-images yang disimpan cukup teksnya saja.

Bisakah aku meninjau sebuah live setelah selesai?

Bisa, kalau kamu menyimpannya. Mulai dengan --ximilar-stream NEW dan setiap kartu yang tercantum di riwayat masuk ke sebuah sesi di akun Ximilar-mu selama live berjalan, lengkap dengan harganya, lamanya tampil di siaran, dan potongan gambar yang dipakai untuk mengidentifikasinya. Setelah itu buka bagian Cardstream di aplikasi Ximilar: nilai live-nya, produk paling bernilai dan set teratasnya, setiap kartu dengan gambarnya. Tandai yang terjual dan perbaiki hasil cocok yang keliru. Harus restart di tengah live? Berikan id sesi sebagai pengganti NEW dan live berlanjut, bahkan kalau sesinya sudah ditutup. Menyimpan ke workspace tim memakai --ximilar-workspace. Selengkapnya.

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

Bisakah kujalankan di LAN supaya komputer lain bisa membuka antarmukanya?

Jangan. Antarmuka web-nya tanpa autentikasi dan memegang kunci API-mu, jadi tempatnya hanya di 127.0.0.1, tidak di tempat lain. Container mengikat 0.0.0.0 secara internal, dan karena itulah docker run yang didokumentasikan hanya memublikasikan port ke 127.0.0.1. Kalau kamu memang perlu mengaksesnya dari komputer lain, pasang tunnel berautentikasi milikmu sendiri di depannya alih-alih membuka port-nya.

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