İndir

cardstream’i çalıştır

macOS ve Linux’ta tek komut; daha fazla denetim istediğinde bir sürüm wheel’i, bir Dockerfile ve kaynak koddan derleme. macOS arm64, Linux amd64 ve Windows amd64, hepsi aynı saf Python sürümüyle karşılanır.

Kurulum betiği

Tek komutla kur

~/.cardstream içinde bir sanal ortam oluşturur, sürüm wheel’ini sağlama toplamlarıyla doğrular, model ağırlıklarını indirir ve cardstream-web ile cardstream-client komutlarını PATH’ine ekler. Sende varsa uv kullanır.

$ curl -fsSL https://raw.githubusercontent.com/Ximilar-com/cardstream/main/scripts/install.sh | sh
$ export XIMILAR_API_KEY=your-key
$ cardstream-web
# → http://127.0.0.1:8001 — bir kart göster

Gerekirse ayarlar

CARDSTREAM_VERSION — en son sürüm yerine belirli bir sürüm etiketine sabitle, örn. v0.5.0
CARDSTREAM_HOME — venv ile modelleri barındıran kurulum kökü (varsayılan ~/.cardstream)
INSTALL_DIR — cardstream-web / cardstream-client sarmalayıcılarının konacağı yer (varsayılan ~/.local/bin)
CARDSTREAM_MODELS_BASE_URL — model başına ağırlık tarball’ları için alternatif sunucu
CARDSTREAM_MODEL_ARCHIVES — oradan hangi tarball’ların indirileceği (boşlukla ayrılmış)
CARDSTREAM_EXTRAS — kurulacak pip ek paketleri (varsayılan client,onnx)
CARDSTREAM_TRACKER_URL — isteğe bağlı vitTracker .onnx dosyası (varsayılan: OpenCV zoo)

Doğrula

Kurulumu doğrula

Betik, herhangi bir şey kurmadan önce wheel’i sürümün SHA256SUMS dosyasıyla doğrular. Sonrasında, makinende ne olduğunu tek bir bayrak gösterir:

$ cardstream-web --version
cardstream 0.5.0

Dosyaları kendin mi indirdin? Betiğin yaptığı gibi denetle: shasum -a 256 -c SHA256SUMS.

Elle indirme

Doğrudan sürümden

Paket PyPI üzerinde; her GitHub sürümü de aynı wheel ile sdist’i bir SHA256SUMS dosyasının yanında taşır. Saf Python tek bir wheel bütün platformları karşılar:

$ pip install 'cardstream[client,onnx]'

Windows

Kurulum betiği yalnızca POSIX içindir; Windows’ta PyPI üzerinden kur, model başına ağırlık tarball’larını modeller sürümünden aç ve bayrakları onlara yönlendir:

> py -3.11 -m venv cardstream-env
> cardstream-env\Scripts\activate
> pip install 'cardstream[client,onnx]'
> set XIMILAR_API_KEY=your-key
> cardstream-web --segmentor-model models\segmentation_model\onnx\model.onnx ^
    --embed-model models\similarity_model\onnx\model.onnx

Karşılaştır

Yolunu seç

Yol	En uygun olduğu durum	İlk doğrulama
Kurulum betiği	localhost’ta en hızlı kurulumu istiyorsun: venv, model ağırlıkları ve PATH’teki sarmalayıcılar senin yerine halledilir.	`cardstream-web --version`
Docker	Temiz bir sistem ya da encoder’ın yakınındaki bir makinede OBS’in gönderdiği yayını almak.	`curl -s http://127.0.0.1:8001/mode`
Kaynak koddan derle	Kodu değiştiriyorsun.	`pytest -q tests/core/test_engine.py`

Docker

Bir konteynerde çalıştır

İmaj, ilk çalıştırmada model ağırlıklarını bir Docker birimine (volume) indirir ve web istemcisini başlatır. Depodaki Dockerfile ile derle:

$ git clone https://github.com/Ximilar-com/cardstream && cd cardstream
$ docker build -t cardstream .
$ docker run --rm -e XIMILAR_API_KEY -p 127.0.0.1:8001:8001 \
    -v cardstream-models:/models cardstream

Konteyner içeride 0.0.0.0’a bağlanır; portu yukarıdaki gibi yalnızca 127.0.0.1’e yayımla. Uygulamada kimlik doğrulama yoktur ve Ximilar API anahtarını barındırır; onu asla yerel ağa ya da internete açma.

Kaynak kod

Kaynak koddan derle

Deponun bir kopyası, tek bir betik ve ilk doğrulaman olarak çevrimdışı test paketi. --models ağırlıkları da indirir.

$ git clone https://github.com/Ximilar-com/cardstream && cd cardstream
$ ./scripts/build-from-source.sh --models
$ source .venv/bin/activate
$ cardstream-web --version

cardstream’i çalıştır

Tek komutla kur

Gerekirse ayarlar

Kurulumu doğrula

Doğrudan sürümden

Windows

Yolunu seç

Bir konteynerde çalıştır

Kaynak koddan derle

Sonraki adımlar

Kur ve çalıştır →

Yayınını ver →

Güvenle işlet →

Güncelle ya da kaldır →