rtag is a command-line photo tagging tool based on rclip and powered by the awesome OpenAI's CLIP neural network.
When run without arguments, rtag tags all of the images in the current directory, including subdirectories, with the most relevant tags out of the imagenet-1k tag list. rtag writes the tags to the images' metadata, in a format supported by most photo management software. rtag supports JPG images only.
cd photos && rtagYou can use your own tag list by providing a path to a file with tags as an argument to rtag.
cd photos && rtag --tags-filepath /path/to/your/tag/list.txtThe tag list file should contain one tag per line.
You can also adjust a --threshold used to filter out tags with a lower
confidence score. Run rtag in the --dry-run mode to see the confidence
scores for each tag that passes the threshold.
rtag --helpThis repository follows the Conventional Commits standard.
To run rtag locally from the source code, you must have Python and Poetry installed.
Then do:
# clone the source code repository
git clone git@github.com:yurijmikhalevich/rtag.git
# install dependencies and rtag
cd rtag
poetry install
# activate the new poetry environment
poetry shellIf the poetry environment is active, you can use rtag locally, as described in the Usage section above.