Stažení a instalace Desktopu a CLI

Animal Detector můžete používat jako Desktop s grafickým ovládáním nebo jako CLI v příkazové řádce. Obě varianty najdete na stránce Stažení. Tento návod vás provede výběrem balíčku a prvním spuštěním; fotografie zatím zpracovávat nemusíte.

1. Vyberte aplikaci, systém a verzi

Desktop zvolte pro práci v okně aplikace a vizuální kontrolu fotografií. CLI je vhodné pro příkazovou řádku, dávkové úlohy a automatizaci.

Na stránce Stažení vyhledejte svůj systém a architekturu:

• Windows x64: 64bitové počítače s procesorem Intel nebo AMD.
• macOS ARM64: Macy s čipem Apple Silicon, například řady M1, M2 a novější. Typ čipu zjistíte v nabídce Apple → O tomto Macu. ARM64 balíček není určený pro Mac s procesorem Intel.
• Linux x64: 64bitové počítače Intel nebo AMD; v aktuální nabídce jde o CLI.

Nabídka se může mezi vydáními lišit. Stahujte pouze balíček odpovídající vašemu systému a architektuře; chybějící variantu nenahrazujte souborem pro jiný systém.

Stabilní verze je určená pro běžné používání. Testovací verze, označená příponou -test, slouží k ověřování změn. Testovací vydání používá výchozí testovací službu, stabilní vydání produkční službu. Před navázáním na běžnou práci zkontrolujte verzi a nastavení prostředí. Na stránce jsou vždy uvedené právě dostupné soubory a jejich verze.

Klikněte na Stáhnout u zvoleného souboru a počkejte na dokončení stahování. Další postup závisí na tom, zda jste vybrali instalátor, přenosný ZIP nebo archiv.

2. Desktop ve Windows: instalační verze EXE

1. Stáhněte soubor označený Instalační verze (EXE). Název začíná AnimalDetector-Setup-, u testovacího vydání AnimalDetectorTest-Setup-.
2. Otevřete stažený soubor a dokončete průvodce instalací.
3. Spusťte Animal Detector, případně Animal Detector Test, přes vytvořeného zástupce nebo nabídku Start.

Instalační verze je pohodlná volba pro pravidelné používání ve Windows. Pokud ji stránka u vašeho vydání nenabízí, použijte přenosnou verzi podle následujícího postupu.

3. Desktop ve Windows: přenosná verze ZIP

1. Stáhněte soubor označený Přenosná verze (ZIP).
2. V Průzkumníku použijte Extrahovat vše a vyberte složku, ve které chcete aplikaci ponechat.
3. Otevřete rozbalenou složku a spusťte AnimalDetector.exe, u testovacího vydání AnimalDetectorTest.exe.

Spouštějte aplikaci z rozbalené složky, nikoli přímo ze ZIPu. Ponechte pohromadě celý obsah balíčku; samotný EXE soubor bez ostatních souborů nestačí. Přenosná verze nevyžaduje průvodce instalací.

4. Desktop v macOS: archiv TAR.GZ

1. Stáhněte Desktop archiv pro macOS ARM64.
2. Ve Finderu otevřete soubor .tar.gz a rozbalte jej.
3. V rozbaleném obsahu najděte AnimalDetector.app a přesuňte aplikaci do složky Aplikace.
4. Spusťte AnimalDetector.app.

Některá vydání pro macOS nejsou podepsaná. Pokud systém takový balíček zablokuje, u aplikace stažené z oficiální stránky můžete použít následující postup z dokumentace. V Terminálu přejděte do složky obsahující AnimalDetector.app a spusťte:

codesign --force --deep --sign - --timestamp=none "./AnimalDetector.app"
xattr -dr com.apple.quarantine "./AnimalDetector.app"
open "./AnimalDetector.app"

První příkaz vytvoří místní podpis, druhý odstraní příznak karantény a třetí aplikaci otevře. Tento postup použijte jen pro balíček, jehož původu důvěřujete; po nahrazení aplikace nově staženým archivem může být potřeba jej zopakovat.

5. CLI ve Windows

1. Stáhněte CLI archiv pro Windows x64 a rozbalte celý ZIP.
2. Otevřete PowerShell v rozbalené složce, která obsahuje animal-detector-cli.cmd.
3. Zobrazte nápovědu:

.\animal-detector-cli.cmd --help

CLI vypíše verzi a dostupné příkazy. Dvojité kliknutí na soubor není vhodný způsob běžné práce s CLI: okno může po dokončení příkazu zmizet. Příkazy zadávejte v otevřeném terminálu.

6. CLI v macOS a Linuxu

1. Stáhněte CLI archiv pro macOS ARM64 nebo Linux x64.
2. Rozbalte celý archiv .tar.gz.
3. V Terminálu přejděte do rozbalené složky obsahující animal-detector-cli a zobrazte nápovědu:

./animal-detector-cli --help

Pokud rozbalení nezachovalo práva ke spuštění a terminál hlásí Permission denied, ve stejné složce obnovte práva spouštěče a přibaleného běhového prostředí:

chmod +x ./animal-detector-cli ./bin/node
./animal-detector-cli --help

CLI balíčky obsahují vlastní Node.js a potřebné součásti. Pro první spuštění nemusíte instalovat Node.js ani spouštět npm install. Ponechte pohromadě celý rozbalený balíček včetně složek bin, dist, node_modules a models.

7. První spuštění a další práce

Po otevření Desktopu pokračujte podle návodu k desktopové aplikaci. Nejprve vyberte složku nebo projekt a zkontrolujte režim zpracování.

U CLI začněte nápovědou z předchozích kroků. Obsahuje seznam příkazů, jejich parametry a příklady použití. Samotné --help fotografie nevyhodnocuje. Příkaz process spouštějte až po volbě vstupní složky a režimu.

Lokální ONNX, lokální Docker a serverové vyhodnocení mají rozdílné požadavky. Docker potřebujete pouze pro zvolený režim lokálního Dockeru, nikoli pro samotné otevření Desktopu nebo nápovědy CLI. Přehled najdete v článku Zpracování a ukládání dat.

Když se aplikace nespustí

• Nesprávný systém nebo architektura: vraťte se na stránku Stažení a zkontrolujte označení balíčku.
• Chybějící soubory: rozbalte celý archiv znovu do nové složky. Nespouštějte jen EXE nebo spouštěč vytažený z balíčku.
• CLI nenajde příkaz: ověřte, že jste v adresáři se spouštěčem a používáte předponu .\ ve Windows nebo ./ v macOS a Linuxu.
• macOS zablokuje nepodepsaný Desktop: použijte postup v části o macOS, pokud jste balíček získali z oficiálního zdroje.

Při kontaktování podpory uveďte systém, architekturu, název staženého souboru, verzi aplikace a přesné znění chyby.