Často kladené dotazy

Co je potřeba ke spuštění?

Počítač s Pythonem 3.11 nebo novějším, a to je zhruba všechno. macOS arm64, Linux amd64 i Windows amd64 pokrývá totéž vydání v čistém Pythonu, GPU není potřeba. Systémový ffmpeg je nutný jen pro stahované a přijímané zdroje (RTSP, RTMP, SRT); webkamera, soubor ani rozhraní v prohlížeči ho nepotřebují.

Kam instalační skript co ukládá?

Na dvě místa. ~/.cardstream je kořen instalace: virtuální prostředí ve venv/ a váhy modelů v models/. Oba příkazy, cardstream-web a cardstream-client, jsou malé spouštěcí skripty zapsané do ~/.local/bin; spouštějí programy z virtuálního prostředí s už vyplněnými cestami k modelům, takže každý přepínač, který zadáte, má přednost. Obě umístění změníte přes CARDSTREAM_HOME a INSTALL_DIR. Ničeho dalšího na počítači se nedotkne, a hlavně skript nikdy neupravuje profil vašeho shellu: pokud ~/.local/bin není ve vaší PATH, vypíše upozornění a změnu nechá na vás.

Jak aktualizuji na novou verzi?

Spusťte znovu tentýž jednořádkový příkaz. Nainstaluje aktuální vydání do stávajícího virtuálního prostředí a přepíše spouštěcí skripty. Váhy, které už leží v ~/.cardstream/models, nechá být (stahují se jen tehdy, když chybí), takže aktualizace je malé stahování, ne další čtvrt gigabajtu. Pokud chcete místo nejnovějšího konkrétní vydání, nastavte CARDSTREAM_VERSION.

# tentýž jednořádkový příkaz; /install.sh přesměruje na skript ve větvi 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

Jak ho odinstaluji?

Dvěma příkazy. První odstraní virtuální prostředí a váhy modelů, druhý oba spouštěcí skripty. Nic dalšího uklízet nemusíte: žádný démon, žádná položka po přihlášení, žádný systémový balíček.

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

Pokud jste instalovali s nastavenou proměnnou CARDSTREAM_HOME nebo INSTALL_DIR, odstraňte místo toho tyto cesty, a pokud jste spouštěcí skripty nasměrovali do systémového adresáře, použijte sudo. Co jste přidali ručně, musíte vrátit sami: řádek s PATH v profilu shellu, export XIMILAR_API_KEY a každou složku, kterou jste předali přepínači --store-images. Nic dalšího aplikace do vašeho domovského adresáře nezapisuje. Že je pryč, ověříte příkazem command -v cardstream-web v novém shellu; ten starý si cestu pamatuje, dokud nespustíte hash -r.

Potřebuji GPU?

Ne. Dodávané váhy jsou exporty ONNX dimenzované pro CPU a všechno, co lokální engine dělá (filtr pohybu, omezování detekce i embedding, který odpovídá na otázku „stejná, nebo nová karta?“), běží na procesoru, který už máte. GPU je možnost pro vaše vlastní přesnější váhy, nikdy podmínka pro výchozí nastavení.

Funguje to s Whatnotem nebo Fanatics Live?

Ano, i když ne napojením na samotnou platformu: odebírá video, které už vytváříte. Virtuální kamera OBS, druhý výstup RTMP nebo SRT vedle toho, který posílá obraz na platformu, stahování přes RTSP z enkodéru, nebo prostě vlastní kamera namířená na stejnou podložku. Návod pro živý prodej projde všechny čtyři cesty od začátku do konce.

Co doopravdy opouští můj počítač?

V klientském režimu jeden výřez JPEG na každou novou kartu. Ne stream, ne snímky kolem, ne zbytek podložky. Každé rozhodnutí o tom, zda vůbec něco poslat, padne nejdřív lokálně, takže hodina videa, ve které ukážete sto karet, znamená sto malých požadavků. Jedinou výjimku si zapínáte sami: s --ximilar-stream se historie vysílání (textový řádek ke každé kartě a výřez, podle kterého byla rozpoznána) ukládá také do relace ve vašem vlastním účtu Ximilar. Ve výchozím stavu vypnuto a --no-ximilar-stream-images omezí ukládání jen na text.

Můžu si vysílání projít později?

Ano, pokud ho uložíte. Spusťte s --ximilar-stream NEW a každá karta z historie (s cenou, časem na streamu a výřezem, podle kterého byla rozpoznána) se během vysílání ukládá do relace ve vašem účtu Ximilar. Potom otevřete sekci Cards Cloud v aplikaci Ximilar: hodnota vysílání, nejcennější produkty a nejčastější edice, každá karta i s obrázkem; označte, co se prodalo, a opravte chybnou shodu. Restart uprostřed vysílání? Místo NEW předejte ID relace a vysílání pokračuje, i když už byla relace uzavřená. Ukládání do týmového pracovního prostoru zajistí --ximilar-workspace. Podrobnosti.

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

Můžu ho spustit v místní síti, aby rozhraní otevřel i jiný počítač?

Nedělejte to. Webové rozhraní nemá ověřování a drží váš API klíč, takže patří na 127.0.0.1 a nikam jinam. Kontejner uvnitř naslouchá na 0.0.0.0, a proto zdokumentovaný docker run zveřejňuje port jen na 127.0.0.1. Pokud ho z jiného počítače opravdu potřebujete, dejte před něj vlastní tunel s ověřováním, místo abyste otevírali port.

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