From c3d35097ef3946b2594201f5bdf4dba9708e0ced Mon Sep 17 00:00:00 2001 From: CorentinB Date: Sun, 19 Aug 2018 14:04:06 +0200 Subject: [PATCH] Modify: README - Updated README.md --- README.md | 42 +++++++++++++++++++++++++++++------------- 1 file changed, 29 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index ab13c40..b76ecc3 100644 --- a/README.md +++ b/README.md @@ -11,28 +11,43 @@ Because sometimes, you have folders full of badly named pictures, and you want t # Prerequisites & installation -You need Docker installed, and you need to pull the DeepDetect image. +You need DeepDetect installed, the easiest way is using docker: ``` docker pull beniz/deepdetect_cpu +docker run -d -p 8080:8080 -v /path/to/images:/path/to/images beniz/deepdetect_cpu ``` -First download the latest release from https://github.com/CorentinB/DeepSort/releases -Make it executable with: +PLEASE NOTE THAT THE PATH IN THE HOST SHOULD BE THE SAME IN THE CONTAINER! +Example: ``` -chmod +x deepsort +docker run -d -p 8080:8080 -v /home/corentin/Images:/home/corentin/Images beniz/deepdetect_cpu ``` -You also need your local 8080 port to not be mapped already. - -# Usage +If you prefeer using DeepDetect without Docker, refeer to the official documentation here: +https://github.com/jolibrain/deepdetect/blob/master/README.md +You'll find how to install it without Docker. -Just input a folder, and it will recursively rename all the pictures the following way: +Then, download the latest DeepSort release from https://github.com/CorentinB/DeepSort/releases +Unzip your release, rename it `deepsort` and make it executable with: ``` -identified-image-class_hash.ext -``` -To start the tagging: +chmod +x deepsort ``` -./deepsort FOLDER + +# Usage + +Right now, DeepSort doesnt support a lot of different parameters, you're obliged to fill two of them: +`--url` or `-u` that correspond to the URL of your DeepDetect server. +`--input` or `-i` that correspond to your local folder full of images. + +For more informations, refeer to the helper: +```./deepsort --help +usage: deepsort [-h|--help] -u|--url "" -i|--input "" + AI powered image tagger backed by DeepDetect +Arguments: + + -h --help Print help information + -u --url URL of your DeepDetect instance (i.e: http://localhost:8080) + -i --input Your input folder. ``` # (Really really quick) Benchmark @@ -41,6 +56,7 @@ Tested on 605 files, it took 11m18s on an i7 7700K. # Todo list -- [ ] Getting docker out of the loop (each user install his own DeepDetect) +- [X] Getting docker out of the loop (each user install his own DeepDetect) - [ ] ResNet 50 integration - [ ] XMP metadata writing +- [ ] GPU support