{"id":45171162,"url":"https://github.com/AlvaroCavalcante/auto_annotate","last_synced_at":"2026-03-05T06:00:34.547Z","repository":{"id":37451633,"uuid":"229821430","full_name":"AlvaroCavalcante/auto_annotate","owner":"AlvaroCavalcante","description":"Labeling is boring. Use this tool to speed up your next object detection project!","archived":false,"fork":false,"pushed_at":"2024-07-05T18:54:21.000Z","size":56804,"stargazers_count":162,"open_issues_count":7,"forks_count":34,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-09-24T21:55:09.629Z","etag":null,"topics":["annotation-tool","computer-vision","dataset-generation","labeling-tool","object-detection","pattern-recognition","python","python3","semi-supervised-learning","tensorflow","weak-supervision"],"latest_commit_sha":null,"homepage":"https://medium.com/p/acf410a600b8#9e0e-aaa30a9f4b7a","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlvaroCavalcante.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-12-23T20:53:15.000Z","updated_at":"2025-08-18T14:15:21.000Z","dependencies_parsed_at":"2024-01-24T02:29:58.620Z","dependency_job_id":"7f1e887e-e023-4d97-a69d-73d6c14235ce","html_url":"https://github.com/AlvaroCavalcante/auto_annotate","commit_stats":{"total_commits":66,"total_committers":4,"mean_commits":16.5,"dds":0.4696969696969697,"last_synced_commit":"202364bfe6249951d53a3d61b7223791a435e31b"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/AlvaroCavalcante/auto_annotate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlvaroCavalcante%2Fauto_annotate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlvaroCavalcante%2Fauto_annotate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlvaroCavalcante%2Fauto_annotate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlvaroCavalcante%2Fauto_annotate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlvaroCavalcante","download_url":"https://codeload.github.com/AlvaroCavalcante/auto_annotate/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlvaroCavalcante%2Fauto_annotate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30111779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["annotation-tool","computer-vision","dataset-generation","labeling-tool","object-detection","pattern-recognition","python","python3","semi-supervised-learning","tensorflow","weak-supervision"],"created_at":"2026-02-20T08:05:55.701Z","updated_at":"2026-03-05T06:00:34.533Z","avatar_url":"https://github.com/AlvaroCavalcante.png","language":"Jupyter Notebook","readme":"![auto-annotate-logo](https://raw.githubusercontent.com/AlvaroCavalcante/auto_annotate/23fb772ea321877d6850ccb48c45a19da9a6fa48/assets/logo.png)\n\n[![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/AlvaroCavalcante/auto_annotate/blob/master/assets/auto_annotate_example.ipynb)\n\n# Auto Annotation Tool for TensorFlow Object Detection\n\nAre you tired to label your images by hand when working with object detection? Have hundreds or thousands of images to label? Then this project will make your life easier, just create some annotations and let the machine do the rest for you!\n\n# Contents\n\n- [How it works](#how)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Usage](#usage)\n  - [Command line](#command-line)\n  - [Code](#code)\n  - [Google Colab](#colab)\n- [Contribute](#contribute)\n\n# 🤔 How it works \u003ca id=\"how\"\u003e\u003c/a\u003e\n\nThis auto annotation tool is based on the idea of a semi-supervised architecture, where a model trained with a small amount of labeled data is used to produce the new labels for the rest of the dataset.\n\nAs simple as that, the library uses an initial and simplified object detection model to generate the XML files with the image annotations (considering the PASCAL VOC format).\nBesides that, it's possible to define a confidence threshold for the detector, acting as a trade-off for the generated predictions.\n\nIf you want to know more technical details about the project, please, refer to my [Medium article](https://medium.com/p/acf410a600b8#9e0e-aaa30a9f4b7a).\n\n# 📝 Prerequisites \u003ca id=\"prerequisites\"\u003e\u003c/a\u003e\n\nTo use this library you will need a pre-trained object detection model with a subsample of your dataset. As a semi-supervised solution, it's impossible to avoid manual annotation, but you'll need to label just a small amount of your data.\n\nIt's hard to determine the number of images to label manually, once it depends on the complexity of your problem. If you want to detect dogs and cats and have 2000 images in your dataset, for example, probably 200 images are enough (100 per class). On the other hand, if you have dozens of classes or objects that are hard to detect, you should need more manual annotations to see the benefits of the semi-supervised approach.\n\nAfter training this initial model, export your best checkpoint to the [SavedModel](https://www.tensorflow.org/guide/saved_model) format and you'll be ready to use the auto annotation tool!\n\n# 💾 Installation \u003ca id=\"installation\"\u003e\u003c/a\u003e\n\nIt's recommended to use a Python [virtual environment](https://docs.python.org/3/library/venv.html) to avoid any compatibility issue with your TensorFlow version.\n\nIn your environment, you can install the project using pip:\n\n```bash\npip install auto-annotate\n```\n\n# 👨‍🔬 Usage \u003ca id=\"usage\"\u003e\u003c/a\u003e\n\nYou can use this tool either from the command line or directly in your Python code. For both, you'll have the same set of parameters:\n\n- saved_model_path: The path of the **saved_model** folder with the initial model.\n- label_map_path: The path of the **label_map.pbtxt** file.\n- imgs_path: The path of the folder with your dataset images to label.\n- xml_path (**optional**): Path to save the resulting XML files. The default behavior is to save in the same folder of the dataset images.\n- threshold: Confidence threshold to accept the detections made by the model. the defaults is 0.5.\n\n## Command line \u003ca id=\"command-line\"\u003e\u003c/a\u003e\n\nTo use this tool from the command line, you just need to run:\n\n```bash\npython -m auto_annotate --label_map_path /example/label_map.pbtxt \\\n--saved_model_path /example/saved_model \\\n--imgs_path /example/dataset_images \\\n--xml_path /example/dataset_labels \\\n--threshold 0.65\n```\n\n## Code \u003ca id=\"code\"\u003e\u003c/a\u003e\n\nTo use this tool from your Python code, check the following code snippet:\n\n```python\nfrom auto_annotate import AutoAnnotate\n\nann_tool = AutoAnnotate(\n              saved_model_path = '/example/saved_model',\n              label_map_path = '/example/label_map.pbtxt',\n              images_path = '/example/dataset_images',\n              xml_path = '/example/dataset_labels',\n              detection_threshold = 0.65)\n\nann_tool.generate_annotations()\n```\n\n## Google Colab \u003ca id=\"colab\"\u003e\u003c/a\u003e\n\nFor a complete working example, you can refer to this [Google Colab Notebook](https://colab.research.google.com/drive/14qgA9IUYCVAALJmJabvQ9sDxrKxEezwP?usp=sharing), where I share the details about installlation and setup.\n\n# 🤝 Contribute \u003ca id=\"contribute\"\u003e\u003c/a\u003e\n\nContributions are welcome! Feel free to open a new issue if you have any problem to use the library of find a bug!\n\nYou can also use the [discussions](https://github.com/AlvaroCavalcante/auto_annotate/discussions) section to suggest improvements and ask questions! If you find this library useful, don't forget to give it a :star: or support the project:\n\n\u003ca href='https://ko-fi.com/V7V4HQG1E' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi3.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n","funding_links":["https://ko-fi.com/V7V4HQG1E'"],"categories":["public repositories"],"sub_categories":["backend only"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlvaroCavalcante%2Fauto_annotate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlvaroCavalcante%2Fauto_annotate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlvaroCavalcante%2Fauto_annotate/lists"}