Questions fréquentes

De quoi ai-je besoin pour le faire tourner ?

D’une machine avec Python 3.11 ou plus récent, et c’est à peu près tout. macOS arm64, Linux amd64 et Windows amd64 sont tous couverts par la même release en pur Python, sans GPU. Le binaire ffmpeg du système n’est nécessaire que pour les sources en pull et en écoute (RTSP, RTMP, SRT) : une webcam, un fichier ou l’interface navigateur s’en passent.

Où le script d’installation range-t-il les choses ?

À deux endroits. ~/.cardstream est la racine de l’installation : un virtualenv dans venv/ et les poids des modèles dans models/. Les deux commandes, cardstream-web et cardstream-client, sont de petits shims écrits dans ~/.local/bin ; ils lancent les binaires du venv avec les chemins des modèles déjà renseignés, et toute option que vous passez l’emporte. Les deux emplacements se déplacent avec CARDSTREAM_HOME et INSTALL_DIR. Rien d’autre n’est touché sur la machine. En particulier, le script ne modifie jamais le profil de votre shell : si ~/.local/bin n’est pas dans votre PATH, il affiche un message et vous laisse faire le changement.

Comment passer à une nouvelle version ?

Relancez la même commande. Elle installe la release actuelle dans le virtualenv existant et réécrit les shims. Les poids déjà présents dans ~/.cardstream/models ne sont pas touchés (ils ne sont téléchargés que s’ils manquent) : une mise à jour est donc un petit téléchargement, pas un quart de gigaoctet de plus. Pour installer une release précise plutôt que la dernière, définissez CARDSTREAM_VERSION.

# la même commande ; /install.sh redirige vers le script de la branche 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

Comment le désinstaller ?

En deux commandes. La première supprime le virtualenv et les poids des modèles, la seconde supprime les deux shims. Il n’y a rien d’autre à nettoyer : pas de démon, pas d’élément lancé à l’ouverture de session, pas de paquet système.

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

Si vous avez installé avec CARDSTREAM_HOME ou INSTALL_DIR définis, supprimez plutôt ces chemins-là, avec sudo si vous aviez placé les shims dans un répertoire système. Ce que vous avez ajouté à la main reste à défaire par vous : une ligne PATH dans le profil de votre shell, l’export de XIMILAR_API_KEY et tout dossier passé à --store-images. L’application n’écrit rien d’autre dans votre répertoire personnel. Vérifiez qu’il a bien disparu avec command -v cardstream-web dans un nouveau shell : l’ancien garde le résultat en cache jusqu’à ce que vous lanciez hash -r.

Ai-je besoin d’un GPU ?

Non. Les poids fournis sont des exports ONNX dimensionnés pour le CPU, et tout ce que fait le moteur local (le filtre de mouvement, la cadence de détection, l’embedding qui répond à « même carte ou nouvelle carte ? ») tourne sur le processeur que vous avez déjà. Un GPU est une possibilité pour vos propres poids plus précis, jamais une obligation pour les réglages par défaut.

Est-ce que ça fonctionne avec Whatnot ou Fanatics Live ?

Oui, mais pas en se branchant sur la marketplace : il se sert de la vidéo que vous produisez déjà. La caméra virtuelle d’OBS, une seconde sortie RTMP ou SRT à côté de celle qui alimente la plateforme, un flux RTSP récupéré sur un encodeur, ou tout simplement sa propre caméra pointée sur le même tapis. Le guide de la vente en live détaille les quatre méthodes de bout en bout.

Qu’est-ce qui quitte réellement ma machine ?

En mode client, un recadrage JPEG par carte distincte : ni le stream, ni les images autour, ni le reste du tapis. Chaque décision sur le fait d’envoyer ou non quelque chose est d’abord prise en local : une heure de vidéo où vous montrez cent cartes, ce sont cent petites requêtes. La seule exception, c’est vous qui l’activez : avec --ximilar-stream, l’historique du show (une ligne de texte par carte et le recadrage qui a servi à l’identifier) est aussi enregistré dans une session de votre propre compte Ximilar. C’est désactivé par défaut, et --no-ximilar-stream-images s’en tient au texte.

Puis-je revoir un show après coup ?

Oui, si vous l’enregistrez. Démarrez avec --ximilar-stream NEW et chaque carte de l’historique, avec son prix, son temps à l’écran et le recadrage qui a servi à l’identifier, part dans une session de votre compte Ximilar au fil du show. Ouvrez ensuite la section Cardstream de l’application Ximilar : la valeur du show, ses produits les plus chers et ses extensions les plus fréquentes, chaque carte avec son image ; vous y marquez ce qui s’est vendu et corrigez une mauvaise correspondance. Un redémarrage en plein show ? Passez l’id de session à la place de NEW et il reprend, même si la session avait été fermée. Pour enregistrer dans un espace de travail d’équipe, ajoutez --ximilar-workspace. Tous les détails.

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

Puis-je l’ouvrir sur mon réseau local pour afficher l’interface depuis une autre machine ?

Non, ne le faites pas. L’interface web n’a pas d’authentification et détient votre clé API : sa place est sur 127.0.0.1 et nulle part ailleurs. Le conteneur écoute sur 0.0.0.0 en interne, et c’est pourquoi le docker run documenté ne publie le port que sur 127.0.0.1. Si vous en avez vraiment besoin depuis une autre machine, placez votre propre tunnel authentifié devant plutôt que d’ouvrir le port.

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