ImageTagger/readme.md

# ![](./docs/image-analysis.png) Image Tagger

Image Tagger is a simple software application for predicting an image's keywords using a deep learning model based on
resnet.

It allows photographers to automate the image tagging process. 📸

---

## Instructions

1. Download a release from the release page.
2. Unzip the release.
3. Run `ImageTagger\image\bin\ImageTagger`.

![./docs/application.png](./docs/application.png)

Photo credit: [https://unsplash.com/@ndcphoto](https://unsplash.com/@ndcphoto)

## Development

If you want to build the application yourself, you will need Java 17 JDK and the
AI models available in the AIModels release.

The release archive is in the [releases page](https://github.com/dnutiu/ImageTagger/releases).

Note: On Linux desktop related features (opening images, folders) are handled
via [xdg-open](https://linux.die.net/man/1/xdg-open).

### Building and Running from source

To build from source you will need Java 17 JDK and Gradle.

Due to some GitHub limitations that do not allow me to upload large files, you'll need to download the AIModels
zip file which contains the deep learning models and place them into the
`ImageTagger/img-ai/src/main/resources/dev/nuculabs/imagetagger/ai/` path.

To build the project run:

```bash
gradle build
```

To run:

```bash
gradle run
```

# Blog

You can visit my tech blog at [https://blog.nuculabs.dev](https://blog.nuculabs.dev).

# Credits

- Icons: <a href="https://www.flaticon.com/free-icons/image-analysis" title="image analysis icons">Image analysis icons
  created by Dewi Sari - Flaticon</a>