This tool is designed to streamline the process of cropping faces from images, ensuring that you get the perfect crop every time. Whether you're working on a photo management application or simply need to process a batch of images for your next project, our tool is here to help.
- Automatic Face Detection: Utilizes
dlib's andopenCV's powerful face detection to identify faces in any image. - Smart Cropping: Automatically crops images to focus on the detected faces, adjusting the size and aspect ratio as needed.
- Image Standardization: Converts and resizes images to a uniform format and size, making it easier to work with them in your projects.
- Batch Processing: Process an entire folder of images in one go, saving you time and effort.
- Error Handling: Keeps track of images that failed to process, allowing you to easily review and handle exceptions.
Before you begin, ensure you have the following installed:
- Python 3.x
SuggestedPython 3.10.11 [3.11+ discontinuesimghdr, which is a core dependancy]
- Git
Check for troubleshooting here: Troubleshooting
- Download and run the
install.batfrom releases- Will automatically install dependancies and open the ipynb
‼️ If you already have it installed and want to update:- run
troubleshoot.batand then runrun.bat
- run
- Run the
Run.batfile (Will open the .ipynb inside a jupytner notebook on localhost[8888]. - Once Inside the editor of you choice:
- To generate captions for the images, use the WebUI of stable diffusion
- Then move the images AND captions to a folder, and that is the location you should provide for
folder_locinsideImage Captioning Helper/Basic Imports
- Then move the images AND captions to a folder, and that is the location you should provide for
- Run the modules you want from
_Helper.py.- Fill out the variables inside
Basic Image Processing/Basic Init for Image Helperand/orImage Captioning Helper/Basic Importsin_Helper.pyunder their respective module names (Tabs/Locations provided in this message)
- Fill out the variables inside
- Run the modules in an order, do not skip the order of the modules and run a lower one before a higher one, it will break.
- You can skip any modules you do not want to run, but do it in the order of the given modules.
- To generate captions for the images, use the WebUI of stable diffusion
If your Run.bat file does not have a ::test test at the end of it, follow these steps:
- Delete the old repository, download and run the
install.batfrom releases
- Open git bash in the repo location
- Run these commands:
-
git add * git stash git pull - And then run the
run.batfile, everything should work as expected
We welcome contributions! If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! ⭐
Distributed under the GPL-3.0 License. See LICENSE for more information.