This extension aim for helping stable diffusion webui users to use segment anything and GroundingDINO to do stable diffusion inpainting.
2023/04/12
: [Feature] Mask expansion enabled. Thanks @jordan-barrett-jm for your great contribution!2023/04/14
: [Feature] GroundingDINO support with full feature released in master branch! Check it out and use text prompt to automatically generate masks! Also useBatch Process
tab to get LoRA/LyCORIS training set! Note that when you firstly initiate WebUI you may need to wait some time for GroundingDINO to be built. Also make sure that you have access to GitHub on your terminal, otherwise you may need to install manually.cd
to${sd-webui-sam}/
and rungit checkout 99a0fe5
on the terminal to revert back to the previous version without GroundingDINO.
Thanks for suggestions from GitHub Issues, reddit and bilibili to make this extension better.
- [Developing] Support API as mentioned in #15
- Support color inpainting as mentioned in #21
- Support automatic mask generation for hierarchical image segmentation and SD animation
- Support semantic segmentation for batch process, ControlNet segmentation and SD animation
- Connect to ControlNet inpainting and segmentation
- Support WebUI older commits (e.g.
a9fed7c364061ae6efb37f797b6b522cb3cf7aa2
)
Not all plans may ultimately be implemented. Some ideas might not work and be abandoned. Support for old commits has low priority, so I would encourage you to update your WebUI as soon as you can.
If you are unable to add dot, observe list index out of range error on your terminal, or any other error, the most probable reason is that your WebUI is outdated (such as you are using this commitment: a9fed7c364061ae6efb37f797b6b522cb3cf7aa2
).
In most cases, updating your WebUI can solve your problem. Before you submit your issue and before I release support for some old version of WebUI, I ask that you firstly check your version of your WebUI.
Download this extension to ${sd-webui}/extensions
use whatever way you like (git clone or install from UI)
Download segment-anything model from here to ${sd-webui}/models/sam
. Do not change model name, otherwise this extension may fail due to a bug inside segment anything.
To give you a reference, vit_h is 2.56GB, vit_l is 1.25GB, vit_b is 375MB. I myself tested vit_h on NVIDIA 3090 Ti which is good. If you encounter VRAM problem, you should switch to smaller models.
- Launch webui and switch to img2img mode.
- Upload your image
- Optionally add point prompts on the image. Left click for positive point prompt (black dot), right click for negative point prompt (red dot), left click any dot again to cancel the prompt. You must add point prompt if you do not wish to use GroundingDINO.
- Optionally check
Enable GroundingDINO
, select GroundingDINO model you want, write text prompt and pick a box threshold. You must write text prompt if you do not wish to use point prompts. Note that GroundingDINO models will be automatically downloaded from HuggingFace. If your terminal cannot visit HuggingFace, please manually download the model and put it under${sd-webui-sam}/models/grounding-dino
. - Optionally enable previewing GroundingDINO bounding box and click
Generate bounding box
. You must write text prompt to preview bounding box. After you see the boxes with number marked on the left corner, uncheck all the boxes you do not want. If you uncheck all boxes, you will have to add point prompts to generate masks. - Click
Preview Segmentation
button. Due to the limitation of SAM, if there are multiple bounding boxes, your point prompts will not take effect when generating masks. - Choose your favorite segmentation and check
Copy to Inpaint Upload
- Optionally check
Expand Mask
and specify the amount, then clickUpdate Mask
- Click
Switch to Inpaint Upload
button. There is no need to upload another image or mask, just leave them blank. Write your prompt, configurate and clickGenerate
.
- Choose your SAM model, GroundingDINO model, text prompt, box threshold and mask expansion amount. Enter the source and destination directories of your images. The source directory should only contain images.
Output per image
gives you a choice on configurating the number of masks per bounding box. I would highly recommend choosing 3, since some mask might be wierd.save mask
gives you a choice to save the black & white mask andSave original image with mask and bounding box
enables you to save image+mask+bounding_box.- Click
Start batch process
and wait. If you see "Done" below this button, you are all set.
Point prompts demo
demo.mp4
GroundingDINO demo
demo_dino.mp4
Batch process image demo
Input Image | Output Image | Output Mask | Output Blend |
---|---|---|---|
Disclaimer: I have not thoroughly tested this extension, so there might be bugs. Bear with me while I'm fixing them :)
If you encounter a bug, please submit a issue. Please at least provide your WebUI version, your extension version, your browser version, errors on your browser console log if there is any, error on your terminal log if there is any, to make sure that I can find a solution faster.
I welcome any contribution. Please submit a pull request if you want to contribute