Häufig gestellte Fragen

Was brauche ich, um es zu betreiben?

Einen Rechner mit Python 3.11 oder neuer, und das war es fast schon. Dasselbe reine Python-Release deckt macOS arm64, Linux amd64 und Windows amd64 ab, eine GPU ist nicht nötig. Ein systemweit installiertes ffmpeg brauchst du nur für die Pull- und Listen-Quellen (RTSP, RTMP, SRT). Eine Webcam, eine Datei oder die Browser-Oberfläche kommen ohne aus.

Wohin legt das Installationsskript seine Dateien?

An zwei Orte. ~/.cardstream ist das Installationsverzeichnis: ein virtualenv in venv/ und die Modellgewichte in models/. Die beiden Befehle cardstream-web und cardstream-client sind kleine Shims in ~/.local/bin. Sie starten die Programme aus dem venv mit bereits eingetragenen Modellpfaden, sodass jedes Flag, das du angibst, Vorrang hat. Beide Orte lassen sich mit CARDSTREAM_HOME und INSTALL_DIR verlegen. Sonst wird auf dem Rechner nichts angefasst. Vor allem ändert das Skript nie dein Shell-Profil: Liegt ~/.local/bin nicht in deinem PATH, gibt es einen Hinweis aus und überlässt die Änderung dir.

Wie aktualisiere ich auf eine neue Version?

Führe denselben Einzeiler noch einmal aus. Er installiert das aktuelle Release in das vorhandene virtualenv und schreibt die Shims neu. Gewichte, die schon in ~/.cardstream/models liegen, bleiben unberührt (sie werden nur geladen, wenn sie fehlen). Ein Update ist also ein kleiner Download und nicht noch einmal ein Viertelgigabyte. Wenn du statt des neuesten ein bestimmtes Release willst, setz CARDSTREAM_VERSION.

# derselbe Einzeiler; /install.sh leitet auf das Skript auf main um
$ curl -fsSL https://cardstream.ai/install.sh | sh
$ curl -fsSL https://cardstream.ai/install.sh | CARDSTREAM_VERSION=v0.5.0 sh
$ cardstream-web --version

Wie deinstalliere ich es?

Mit zwei Befehlen. Der erste entfernt das virtualenv und die Modellgewichte, der zweite die beiden Shims. Mehr gibt es nicht aufzuräumen: kein Daemon, kein Anmeldeobjekt, kein Systempaket.

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

Wenn du mit gesetztem CARDSTREAM_HOME oder INSTALL_DIR installiert hast, entferne stattdessen diese Pfade, und nimm sudo, falls die Shims in einem Systemverzeichnis liegen. Was du von Hand hinzugefügt hast, musst du auch selbst zurücknehmen: eine PATH-Zeile in deinem Shell-Profil, den Export von XIMILAR_API_KEY und jeden Ordner, den du --store-images übergeben hast. Sonst schreibt die App nichts in dein Home-Verzeichnis. Ob es weg ist, prüfst du mit command -v cardstream-web in einer neuen Shell. Die alte merkt sich den Fundort, bis du hash -r ausführst.

Brauche ich eine GPU?

Nein. Die mitgelieferten Gewichte sind ONNX-Exporte, die für die CPU ausgelegt sind, und alles, was die lokale Engine tut (der Bewegungsfilter, die Drosselung der Detektion, das Embedding, das die Frage „dieselbe Karte oder eine neue?“ beantwortet), läuft auf dem Prozessor, den du schon hast. Eine GPU ist eine Option für eigene, genauere Gewichte, aber nie eine Voraussetzung für die Standardwerte.

Funktioniert es mit Whatnot oder Fanatics Live?

Ja, aber nicht, indem es sich in den Marktplatz einklinkt: Es greift das Video ab, das du ohnehin produzierst. Eine virtuelle Kamera von OBS, eine zweite RTMP- oder SRT-Ausgabe neben der, die die Plattform speist, ein RTSP-Pull von einem Encoder oder einfach eine eigene Kamera, die auf dieselbe Spielmatte zeigt. Die Anleitung für Live-Verkäufer geht alle vier Wege von Anfang bis Ende durch.

Was verlässt meinen Rechner tatsächlich?

Im clientseitigen Modus ein JPEG-Ausschnitt pro neuer Karte, nicht der Stream, nicht die Frames drumherum, nicht der Rest der Matte. Jede Entscheidung darüber, ob überhaupt etwas gesendet wird, fällt zuerst lokal. Eine Stunde Video, in der du hundert Karten zeigst, sind also hundert kleine Anfragen. Die einzige Ausnahme schaltest du selbst ein: Mit --ximilar-stream wird zusätzlich der Verlauf der Show (eine Textzeile pro Karte und der Ausschnitt, an dem sie erkannt wurde) in einer Session in deinem eigenen Ximilar-Konto gespeichert. Standardmäßig aus, und mit --no-ximilar-stream-images bleibt es bei Text.

Kann ich eine Show im Nachhinein auswerten?

Ja, wenn du sie speicherst. Starte mit --ximilar-stream NEW, und jede Karte im Verlauf geht mit ihrem Preis, ihrer Zeit im Stream und dem Ausschnitt, an dem sie erkannt wurde, in eine Session in deinem Ximilar-Konto, während die Show läuft. Öffne danach den Bereich Cardstream der Ximilar-App: der Wert der Show, ihre wertvollsten Produkte und häufigsten Sets, jede Karte mit Bild. Dort markierst du, was verkauft wurde, und korrigierst einen falschen Treffer. Mitten in der Show neu gestartet? Gib statt NEW die Session-ID an, und es geht weiter, auch wenn die Session geschlossen war. Zum Speichern in einem Team-Workspace dient --ximilar-workspace. Die Details.

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

Kann ich es in meinem LAN betreiben, damit ein anderer Rechner die Oberfläche öffnen kann?

Lass es. Die Browser-Oberfläche hat keine Authentifizierung und hält deinen API-Schlüssel, sie gehört also auf 127.0.0.1 und nirgendwohin sonst. Der Container bindet intern an 0.0.0.0, und deshalb veröffentlicht das dokumentierte docker run den Port nur auf 127.0.0.1. Wenn du sie wirklich von einem anderen Rechner aus brauchst, setz einen eigenen authentifizierten Tunnel davor, statt den Port zu öffnen.

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