자주 묻는 질문

실행하려면 무엇이 필요한가요?

Python 3.11 이상이 설치된 컴퓨터, 거의 그게 전부입니다. macOS arm64, Linux amd64, Windows amd64 모두 같은 순수 Python 릴리스로 지원되며 GPU는 필요 없습니다. 시스템 ffmpeg 바이너리는 pull 소스와 listen 소스(RTSP, RTMP, SRT)를 쓸 때만 필요하고, 웹캠, 파일, 브라우저 UI에는 필요하지 않습니다.

설치 스크립트는 파일을 어디에 두나요?

두 곳입니다. ~/.cardstream이 설치 루트로, venv/에 가상 환경(venv)이, models/에 모델 가중치가 들어갑니다. cardstream-web과 cardstream-client 두 명령어는 ~/.local/bin에 기록되는 작은 심(shim) 스크립트로, 모델 경로를 미리 채운 채 venv 안의 바이너리를 exec 하므로 직접 넘긴 플래그가 항상 우선합니다. 두 위치 모두 CARDSTREAM_HOME과 INSTALL_DIR로 바꿀 수 있습니다. 컴퓨터의 다른 곳은 전혀 건드리지 않으며, 특히 셸 프로필은 절대 수정하지 않습니다. ~/.local/bin이 PATH에 없으면 안내 메시지만 출력하고 변경은 사용자에게 맡깁니다.

새 버전으로 업데이트하려면 어떻게 하나요?

같은 한 줄 명령어를 다시 실행하면 됩니다. 기존 가상 환경에 현재 릴리스를 설치하고 심 스크립트를 다시 씁니다. ~/.cardstream/models에 이미 있는 가중치는 그대로 둡니다(가중치는 없을 때만 받아옵니다). 그래서 업데이트는 작은 다운로드로 끝나며, 4분의 1 기가바이트를 또 받는 일은 없습니다. 최신 버전 대신 특정 릴리스를 설치하려면 CARDSTREAM_VERSION을 설정하세요.

# 같은 한 줄 명령어. /install.sh는 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

제거하려면 어떻게 하나요?

명령어 두 개면 됩니다. 첫 번째는 가상 환경과 모델 가중치를, 두 번째는 두 심 스크립트를 삭제합니다. 그 밖에 정리할 것은 없습니다. 데몬도, 로그인 항목도, 시스템 패키지도 없습니다.

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

CARDSTREAM_HOME이나 INSTALL_DIR을 설정하고 설치했다면 대신 그 경로를 삭제하세요. 심 스크립트를 시스템 디렉터리에 두었다면 sudo가 필요합니다. 직접 추가한 것은 직접 되돌려야 합니다. 셸 프로필에 넣은 PATH 줄, XIMILAR_API_KEY export, --store-images에 넘긴 폴더 등이 여기에 해당합니다. 그 밖에 앱이 홈 디렉터리 아래에 쓰는 것은 없습니다. 새 셸에서 command -v cardstream-web을 실행해 사라졌는지 확인하세요. 기존 셸은 hash -r을 실행하기 전까지 이전 조회 결과를 캐시하고 있습니다.

GPU가 필요한가요?

아니요. 기본 제공 가중치는 CPU에 맞게 크기를 맞춘 ONNX 내보내기이고, 로컬 엔진이 하는 모든 일(모션 게이트, 감지 스로틀, "같은 카드인가, 새 카드인가?"에 답하는 임베딩)은 지금 쓰고 있는 프로세서에서 돌아갑니다. GPU는 더 높은 정확도의 자체 가중치를 쓸 때의 선택지일 뿐, 기본 구성에서 필수인 적은 없습니다.

Whatnot이나 Fanatics Live에서도 쓸 수 있나요?

네. 다만 마켓플레이스에 직접 연결하는 방식이 아니라, 이미 만들고 있는 영상을 끌어오는 방식입니다. OBS 가상 카메라, 플랫폼으로 보내는 출력 옆의 두 번째 RTMP 또는 SRT 출력, 인코더에서의 RTSP pull, 아니면 같은 매트를 향한 전용 카메라도 됩니다. 라이브 판매 가이드에서 네 가지 경로를 모두 처음부터 끝까지 다룹니다.

실제로 내 컴퓨터 밖으로 나가는 것은 무엇인가요?

클라이언트 모드에서는 서로 다른 카드 한 장당 JPEG 크롭 한 장뿐입니다. 스트림도, 그 앞뒤의 프레임도, 매트의 나머지 부분도 나가지 않습니다. 무언가를 보낼지 말지에 대한 모든 결정이 먼저 로컬에서 내려지므로, 카드 100장을 보여 준 한 시간짜리 영상은 작은 요청 100건이 됩니다. 단 하나의 예외는 여러분이 직접 켜는 것입니다. --ximilar-stream을 쓰면 방송 기록(카드마다 텍스트 한 줄과 그 카드의 식별에 쓰인 크롭)이 여러분의 Ximilar 계정 안의 세션에도 저장됩니다. 기본값은 꺼져 있으며, --no-ximilar-stream-images를 쓰면 텍스트만 저장됩니다.

방송이 끝난 뒤에 다시 돌아볼 수 있나요?

네, 저장해 두었다면 가능합니다. --ximilar-stream NEW로 시작하면 기록에 오르는 모든 카드가 가격, 방송에 머문 시간, 식별에 쓰인 크롭과 함께 방송이 진행되는 동안 여러분의 Ximilar 계정 안의 세션으로 저장됩니다. 방송이 끝나면 Ximilar 앱의 Cardstream 섹션을 열어 보세요. 방송의 가치, 가장 값비싼 상품과 상위 세트, 이미지가 붙은 모든 카드를 볼 수 있고, 팔린 카드를 표시하거나 잘못된 매칭을 바로잡을 수 있습니다. 방송 도중에 재시작했나요? NEW 대신 세션 id를 넘기면 세션이 닫혔더라도 그대로 이어집니다. 팀 워크스페이스에 저장하려면 --ximilar-workspace를 쓰세요. 자세한 내용.

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

LAN에서 실행해서 다른 컴퓨터에서 UI를 열 수 있나요?

하지 마세요. 웹 UI는 인증이 없고 API 키를 갖고 있으므로 127.0.0.1에만 두어야 합니다. 컨테이너는 내부적으로 0.0.0.0에 바인딩되며, 문서의 docker run이 포트를 127.0.0.1에만 공개하는 것도 그 때문입니다. 정말로 다른 컴퓨터에서 써야 한다면 포트를 여는 대신 인증이 있는 터널을 직접 앞에 두세요.

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