MCPcopy
hub / github.com/NVIDIA/Stable-Diffusion-WebUI-TensorRT

github.com/NVIDIA/Stable-Diffusion-WebUI-TensorRT @v0.2.1 sqlite

repository ↗ · DeepWiki ↗ · release v0.2.1 ↗
127 symbols 398 edges 9 files 0 documented · 0%
README

TensorRT Extension for Stable Diffusion

This extension enables the best performance on NVIDIA RTX GPUs for Stable Diffusion with TensorRT. You need to install the extension and generate optimized engines before using the extension. Please follow the instructions below to set everything up. Supports Stable Diffusion 1.5,2.1, SDXL, SDXL Turbo, and LCM. For SDXL and SDXL Turbo, we recommend using a GPU with 12 GB or more VRAM for best performance due to its size and computational intensity.

Installation

Example instructions for Automatic1111:

  1. Start the webui.bat
  2. Select the Extensions tab and click on Install from URL
  3. Copy the link to this repository and paste it into URL for extension's git repository
  4. Click Install

How to use

  1. Click on the “Generate Default Engines” button. This step takes 2-10 minutes depending on your GPU. You can generate engines for other combinations.
  2. Go to Settings → User Interface → Quick Settings List, add sd_unet. Apply these settings, then reload the UI.
  3. Back in the main UI, select “Automatic” from the sd_unet dropdown menu at the top of the page if not already selected.
  4. You can now start generating images accelerated by TRT. If you need to create more Engines, go to the TensorRT tab.

Happy prompting!

LoRA

To use LoRA / LyCORIS checkpoints they first need to be converted to a TensorRT format. This can be done in the TensorRT extension in the Export LoRA tab. 1. Select a LoRA checkpoint from the dropdown. 2. Export. (This will not generate an engine but only convert the weights in ~20s) 3. You can use the exported LoRAs as usual using the prompt embedding.

More Information

TensorRT uses optimized engines for specific resolutions and batch sizes. You can generate as many optimized engines as desired. Types: - The "Export Default Engines” selection adds support for resolutions between 512 x 512 and 768x768 for Stable Diffusion 1.5 and 2.1 with batch sizes 1 to 4. For SDXL, this selection generates an engine supporting a resolution of 1024 x 1024 with a batch size of 1. - Static engines support a single specific output resolution and batch size. - Dynamic engines support a range of resolutions and batch sizes, at a small cost in performance. Wider ranges will use more VRAM. - The first time generating an engine for a checkpoint will take longer. Additional engines generated for the same checkpoint will be much faster.

Each preset can be adjusted with the “Advanced Settings” option. More detailed instructions can be found here.

Common Issues/Limitations

HIRES FIX: If using the hires.fix option in Automatic1111 you must build engines that match both the starting and ending resolutions. For instance, if the initial size is 512 x 512 and hires.fix upscales to 1024 x 1024, you must generate a single dynamic engine that covers the whole range.

Resolution: When generating images, the resolution needs to be a multiple of 64. This applies to hires.fix as well, requiring the low and high-res to be divisible by 64.

Failing CMD arguments:

  • medvram and lowvram Have caused issues when compiling the engine.
  • api Has caused the model.json to not be updated. Resulting in SD Unets not appearing after compilation.
  • Failing installation or TensorRT tab not appearing in UI: This is most likely due to a failed install. To resolve this manually use this guide.

Requirements

Driver:

Linux: >= 450.80.02 - Windows: >= 452.39

We always recommend keeping the driver up-to-date for system wide performance improvements.

Core symbols most depended-on inside this repo

update
called by 14
model_manager.py
load
called by 10
utilities.py
info
called by 5
model_helper.py
available_models
called by 4
model_manager.py
get_onnx_path
called by 3
model_manager.py
write_json
called by 3
model_manager.py
get_default
called by 3
datastructures.py
switch_engine
called by 3
scripts/trt.py

Shape

Method 85
Function 28
Class 14

Languages

Python100%

Modules by API surface

scripts/trt.py24 symbols
datastructures.py23 symbols
model_helper.py21 symbols
model_manager.py17 symbols
utilities.py16 symbols
ui_trt.py14 symbols
exporter.py8 symbols
scripts/lora.py3 symbols
install.py1 symbols

For agents

$ claude mcp add Stable-Diffusion-WebUI-TensorRT \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact