blepping-ComfyUI-bleh/blehconfig.example.yaml

# Copy this file to blehconfig.yaml
previews:
    # If disabled, will use the old ComfyUI previewer.
    enabled: true

    # Maximum preview size (applies to both height and width).
    max_size: 768

    # Maximum preview width. If set, will override max_size.
    max_width: 768

    # Maximum preview height. If set, will override max_size.
    max_height: 768

    # Maximum batch items to preview.
    max_batch: 4

    # Maximum columns to use when previewing batches.
    max_batch_cols: 2

    # Minimum time between updating previews. The default will update the preview at most once per second.
    throttle_secs: 1

    # Can be set to use a different throttle time for video previews.
    # Only applies when generating more than one frame.
    # If unset or null it will use throttle_secs.
    throttle_secs_video: 6

    # Can be set to use a different throttle time when using the fallback previewer
    # (anything other than TAESD or TAEVID). If unset or null it will use throttle_secs.
    throttle_secs_fallback: null

    # When enabled and previewing batches, you will see previews spread across the batch. Otherwise it will be the first max_batch items.
    maxed_batch_step_mode: false

    # Allows overriding the preview device, for example you could set it to "cpu". Note: Generally should be left
    # alone unless you know you need to change it. Previewing on CPU will likely be quite slow.
    preview_device: null

    # Can be set to override the previewer dtype (which probably defaults to float32).
    # You may set it to a specific dtype: float32, float16, bfloat16
    # Setting it to "keep" just leaves the dtype alone (which is probably float32).
    # Setting it to "vae" will use whatever dtype ComfyUI is set to use for VAE.
    preview_dtype: bfloat16

    # Uses non-blocking transfers for previews when the device supports it.
    # Not recommended as it is extremely likely to corrupt previews, especially if the previewer
    # is relatively slow or the latent is large (video models, Chroma Radiance). However,
    # it might decrease the performance impact of previewing.
    preview_non_blocking: false

    # Allows skipping upscale layers in the TAESD model, may increase performance when previewing large images or batches.
    # May be set to -1 (conservative) or -2 (aggressive) to automatically calculate how many to skip. See README.md for details.
    skip_upscale_layers: 0

    # Controls whether the previewer model is compiled (using torch.compile). Only works if your
    # Torch version and GPU support compiling. This also may cause a delay/memory spike on decoding the first preview.
    # This may be a boolean or object with arguments to pass to torch.compile. For example:
    #   compile_previewer:
    #     mode: max-autotune
    #     backend: inductor
    compile_previewer: false

    # Controls behavior if we run out of memory trying to decode the preview.
    # Possible values: none, latent2rgb
    oom_fallback: "latent2rgb"

    # When enabled, we will try to use the normal previewer on each call
    # and only use the fallback if the normal previewer fails.
    # When disabled, we use the fallback starting from the first OOM.
    oom_retry: true

    # List of lowercase latent format names from https://github.com/Comfy-Org/ComfyUI/blob/master/comfy/latent_formats.py
    # If the list is empty, this disables the whitelist. Otherwise, Bleh will
    # only handle previewing for formats in the list.
    whitelist_formats: []

    # List of lowercase latent format names (see above).
    # Bleh will delegate to the normal previewer for any latent formats in the blacklist.
    blacklist_formats: []

    # Controls whether video previewing uses parallel mode (faster, requires much more memory).
    video_parallel: false

    # Maximum frames to include in a preview. -1 means no limit.
    # Frame limiting is treated like batch limiting so maxed_batch_step mode, etc will apply here.
    video_max_frames: -1

    # Number of temporal upscale blocks to run. 2 is the maximum and will fully decode
    # the latent into image frames.
    video_temporal_upscale_level: 0

    # One of:
    #   none: Never use animated previews.
    #   video: Use animated previews for video generations.
    #   batch: Use animated previews for batch generations (batch items will be frames.)
    #   both: Use animated previews for video and batch generations.
    animate_preview: video

    # When enabled, this will add `/bleh/last_preview.html` and `/bleh/last_preview` paths
    # under whatever URI you use to access ComfyUI. The HTML version will serve a webpage
    # that shows the last preview and automatically updates. The non-HTML URI will serve
    # an image (possibly animated) of the last preview.
    # NOTE: When this is enabled, if someone can access your ComfyUI instance then they
    # can see what you're generating, but they already could do that just less conveniently.
    # Access from external hosts is not something ComfyUI enables by default.
    publish_last_preview: false

    # When publishing last previews, the HTML endpoint will only refresh the image at most
    # once every this many seconds.
    publish_last_preview_min_refresh: 5

    # When enabled and a preview is eligible for animation, the animation version will only
    # go to the last preview endpoint. If you don't have the last preview endpoint enabled,
    # then this effectively disabling animations completely. You probably want to
    # leave this on the default because previews can only animated with "Nodes 2.0" which
    # you probably don't want to use, so sending an animated preview to the sampler is pointless.
    only_animate_last_preview: true