Vanliga frågor och svar

Vad behöver jag för att köra det?

En dator med Python 3.11 eller senare, och det är i stort sett allt. macOS arm64, Linux amd64 och Windows amd64 täcks alla av samma release i ren Python, och ingen GPU krävs. Systemets ffmpeg-binär behövs bara för källor som hämtas eller tas emot via en lyssnare (RTSP, RTMP, SRT); en webbkamera, en fil eller webbgränssnittet klarar sig utan.

Var lägger installationsskriptet saker?

På två ställen. ~/.cardstream är installationsroten: en virtualenv i venv/ och modellvikterna i models/. De två kommandona, cardstream-web och cardstream-client, är små startskript (shims) som skrivs till ~/.local/bin. De startar binärerna i venv med modellsökvägarna redan ifyllda, så varje flagga du anger har företräde. Båda platserna går att flytta med CARDSTREAM_HOME och INSTALL_DIR. Inget annat på datorn rörs. Framför allt ändrar skriptet aldrig din shellprofil: om ~/.local/bin inte finns i din PATH skriver det ut ett meddelande och överlåter ändringen åt dig.

Hur uppdaterar jag till en ny version?

Kör samma enradare igen. Den installerar den aktuella releasen i den befintliga virtualenv-miljön och skriver om shim-skripten. Vikter som redan ligger i ~/.cardstream/models lämnas orörda, eftersom de bara hämtas när de saknas. En uppdatering är därför en liten nedladdning, inte ännu en kvarts gigabyte. Vill du hamna på en viss release i stället för den senaste anger du CARDSTREAM_VERSION.

# samma enradare; /install.sh omdirigerar till skriptet på 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

Hur avinstallerar jag det?

Med två kommandon. Det första tar bort virtualenv-miljön och modellvikterna, det andra tar bort de två shim-skripten. Det finns inget mer att städa upp: ingen bakgrundstjänst, inget inloggningsobjekt, inget systempaket.

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

Om du installerade med CARDSTREAM_HOME eller INSTALL_DIR angivna tar du bort de sökvägarna i stället, och använder sudo om du lät shim-skripten hamna i en systemkatalog. Sådant du har lagt till för hand får du också ta bort själv: en PATH-rad i din shellprofil, exporten av XIMILAR_API_KEY och eventuella mappar som du har angett till --store-images. Appen skriver ingenting annat under din hemkatalog. Kontrollera att det är borta med command -v cardstream-web i ett nytt shell; det gamla cachar sökningen tills du kör hash -r.

Behöver jag en GPU?

Nej. De medföljande vikterna är ONNX-exporter dimensionerade för CPU, och allt den lokala motorn gör (rörelsespärren, strypningen av detekteringen, embeddingen som besvarar frågan ”samma kort eller nytt kort?”) körs på den processor du redan har. En GPU är ett alternativ för egna vikter med högre träffsäkerhet, aldrig ett krav för standardinställningarna.

Fungerar det med Whatnot eller Fanatics Live?

Ja, men inte genom att koppla upp sig mot marknadsplatsen: det kopplar in sig på den video du redan producerar. En virtuell kamera i OBS, en andra RTMP- eller SRT-utgång bredvid den som matar plattformen, en RTSP-hämtning från en kodare eller helt enkelt en egen kamera riktad mot samma spelmatta. Guiden för dig som säljer live går igenom alla fyra vägarna från början till slut.

Vad lämnar egentligen min dator?

I klientläget ett JPEG-utsnitt per unikt kort. Inte streamen, inte bildrutorna runt omkring, inte resten av mattan. Frågan om något över huvud taget ska skickas avgörs alltid lokalt först, så en timmes video där du visar hundra kort blir hundra små anrop. Det enda undantaget slår du själv på: med --ximilar-stream sparas också sändningens historik, en textrad per kort plus utsnittet som kortet identifierades från, i en session på ditt eget Ximilar-konto. Avstängt som standard, och med --no-ximilar-stream-images sparas enbart text.

Kan jag gå igenom en sändning i efterhand?

Ja, om du sparar den. Starta med --ximilar-stream NEW så hamnar varje kort som historiken listar, med pris, tid i streamen och utsnittet som det identifierades från, i en session på ditt Ximilar-konto medan sändningen pågår. Öppna Cardstream-delen av Ximilar-appen efteråt: sändningens värde, dess mest värdefulla produkter och vanligaste set, varje kort med bild. Där markerar du vad som såldes och rättar en felaktig träff. Omstart mitt i sändningen? Ange sessionens id i stället för NEW så fortsätter den, även om den hade stängts. För att spara i en arbetsyta för teamet används --ximilar-workspace. Detaljerna.

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

Kan jag köra det på mitt LAN så att en annan dator kan öppna gränssnittet?

Gör inte det. Webbgränssnittet saknar inloggning och har din API-nyckel, så det hör hemma på 127.0.0.1 och ingen annanstans. Containern binder 0.0.0.0 internt, och därför publicerar det dokumenterade docker run-kommandot porten enbart mot 127.0.0.1. Om du verkligen behöver nå det från en annan dator lägger du en egen autentiserad tunnel framför, i stället för att öppna porten.

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