{"id":13585099,"url":"https://github.com/torresflo/Tag-Machine","last_synced_at":"2025-04-07T06:32:39.462Z","repository":{"id":52186622,"uuid":"420570638","full_name":"torresflo/Tag-Machine","owner":"torresflo","description":"A little Python application to auto tag your photos with the power of machine learning.","archived":false,"fork":false,"pushed_at":"2023-07-05T11:12:15.000Z","size":3251,"stargazers_count":41,"open_issues_count":4,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-06T02:38:35.877Z","etag":null,"topics":["auto-tagging","computer-vision","image-classification","image-tagger","image-tagging","image-to-text","machine-learning","photo-tag","photo-tagging","pretrained-models","python","pytorch","pytorch-transformers"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/torresflo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-24T02:41:33.000Z","updated_at":"2024-10-12T21:23:52.000Z","dependencies_parsed_at":"2024-11-06T03:03:07.903Z","dependency_job_id":"a7bf4299-2566-451d-93eb-1d8136e1116c","html_url":"https://github.com/torresflo/Tag-Machine","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torresflo%2FTag-Machine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torresflo%2FTag-Machine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torresflo%2FTag-Machine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torresflo%2FTag-Machine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/torresflo","download_url":"https://codeload.github.com/torresflo/Tag-Machine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247607505,"owners_count":20965942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auto-tagging","computer-vision","image-classification","image-tagger","image-tagging","image-to-text","machine-learning","photo-tag","photo-tagging","pretrained-models","python","pytorch","pytorch-transformers"],"created_at":"2024-08-01T15:04:44.597Z","updated_at":"2025-04-07T06:32:39.443Z","avatar_url":"https://github.com/torresflo.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"![GitHub license](https://img.shields.io/github/license/torresflo/Tag-Machine.svg)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n![GitHub contributors](https://img.shields.io/github/contributors/torresflo/Tag-Machine.svg)\n![GitHub issues](https://img.shields.io/github/issues/torresflo/Tag-Machine.svg)\n\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eTag Machine\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A little Python application to auto tag your photos with the power of machine learning.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/torresflo/Tag-Machine/issues\"\u003eReport a bug or request a feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n* [Getting Started](#getting-started)\n  * [Prerequisites and dependencies](#prerequisites-and-dependencies)\n  * [Installation](#installation)\n* [Usage](#usage)\n* [Examples](#examples)\n* [Contributing](#contributing)\n* [License](#license)\n\n## Getting Started\n\n### Prerequisites and dependencies\n\nThis repository is tested on Python 3.7+ and PyTorch LTS 1.8.2.\n\nYou should install Tag Machine in a [virtual environment](https://docs.python.org/3/library/venv.html). If you're unfamiliar with Python virtual environments, check out the [user guide](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/).\nFirst, create a virtual environment with the version of Python you're going to use and activate it.\n\nThen, you will need to install PyTorch.\nPlease refer to [PyTorch installation page](https://pytorch.org/get-started/locally/#start-locally) regarding the specific install command for your platform.\n\nWhen PyTorch is installed, 🤗 Transformers can be installed using pip as follows:\n\n```bash\npip install transformers\n```\n\nYou can refer to the repository of [🤗 Transformers](https://github.com/huggingface/transformers) for more information.\n\nThen you will need to install PySide6, a port of QT for Python used for the graphic interface. It can be installed using pip as follows:\n\n```bash\npip install pyside6\n```\n\nFinally you will need to install IPTCInfo3 to allow Tag Machine to write tags in your images. It can be installed using pip as follows:\n\n```bash\npip install iptcinfo3\n```\n\n### Installation\n\nFollow the instructions above then clone the repo (`git clone https:://github.com/torresflo/Tag-Machine.git`). You can now run `main.py`.\n\n## Usage\n\nPress the button `Load files...` to load your images then press the button `Classify images` to start the classifier. Depending on your machine hardware and the number of images this can take some (and eventually a lot of) time.\n\nThe results are loaded in a table below so you can see which tags are detected for each image.\n\nIf you are satisfied with the results, you can then press the button `Write tags in images` to write the found tags in the metadata of the image (IPTC, IIM Application 2, Keywords). Each tag is appended to the existing ones and will not be written if it already exists.\n\n![Example image](https://github.com/torresflo/Tag-Machine/blob/main/Photos/Example1.png)\n\n## Examples\n\nHere are some examples with results. You can find these images in the folder `Photos`. All images come from the [Wikimedia Commons](https://commons.wikimedia.org/) website.\n\nNote that the detection uses the labels computed by the [PhotoPrism](https://github.com/photoprism/photoprism) project. It allows to regroup similar tags in more generic categories and discard non useful ones. Also, a threshold is also calculated to avoid wrong tagging.\n\n| Image                                                                                      | Tags found                     | Probability |\n| ------------------------------------------------------------------------------------------ | ------------------------------ | ----------- |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/1.jpg\" height=\"300px\"\u003e | tower, architecture            |  97,98%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/2.jpg\" height=\"300px\"\u003e | Nothing                        |  --,--%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/3.jpg\" height=\"300px\"\u003e | dining                         |  87,52%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/4.jpg\" height=\"300px\"\u003e | alpine, landscape, mountain    |  66,37%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/5.jpg\" height=\"300px\"\u003e | Nothing                        |  --,--%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/6.jpg\" height=\"300px\"\u003e | shark, water, fish, animal     |  76,77%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/7.jpg\" height=\"300px\"\u003e | Nothing                        |  --,--%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/8.jpg\" height=\"300px\"\u003e | castle, historic, architecture |  99,64%     |\n| \u003cimg src=\"https://github.com/torresflo/Tag-Machine/blob/main/Photos/9.jpg\" height=\"300px\"\u003e | castle, historic, architecture |  98,44%     |\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the GNU General Public License v3.0. See `LICENSE` for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorresflo%2FTag-Machine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftorresflo%2FTag-Machine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorresflo%2FTag-Machine/lists"}