Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-PromptRelay

ComfyUI Extension: ComfyUI-PromptRelay

Repo Name

ComfyUI-PromptRelay

Author
kijai (Account age: 2878 days)
Nodes
View all nodes(5)
Latest Updated
2026-05-02
Github Stars
0.34K

How to Install ComfyUI-PromptRelay

Install this extension via the ComfyUI Manager by searching for ComfyUI-PromptRelay
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-PromptRelay in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

ComfyUI-PromptRelay Description

ComfyUI-PromptRelay is a ComfyUI node designed to distribute video latent frames across prompt segments, offering flexible inline and block syntax for precise timing control.

ComfyUI-PromptRelay Introduction

ComfyUI-PromptRelay is an innovative extension designed to enhance the creative process for AI artists working with video content. This tool simplifies the task of distributing video frames across different segments, allowing you to focus more on the artistic aspects of your project rather than the technical details. By using ComfyUI-PromptRelay, you can easily manage how your video's narrative unfolds over time, ensuring that each segment receives the appropriate amount of attention and detail. This extension is particularly useful for artists who want to create dynamic and engaging video content without getting bogged down by complex frame calculations.

How ComfyUI-PromptRelay Works

At its core, ComfyUI-PromptRelay operates by taking a single input, known as the smart_prompt, and automatically determining how to allocate your video's frames across various segments. This means you don't have to manually count frames or worry about precise timing. The extension offers two main syntax styles for defining segments: Inline and Block.

  • Inline Syntax: This style uses a pipe (|) to separate segments. You can specify weights for each segment using square brackets ([start-end]), which determine the relative duration of each segment. If weights are omitted, all segments are given equal time.
  • Block Syntax: Here, each segment begins with a header line that includes a number and a colon (e.g., Scene 1:). This header is used to mark the sequence of segments, and the numbers can indicate either equal distribution or proportional distribution based on ranges.

These methods allow you to describe the progression of your video in a structured way, making it easier to convey complex narratives or changes in scenes.

ComfyUI-PromptRelay Features

ComfyUI-PromptRelay comes with several features that enhance its functionality:

  • Smart Prompt Encoding: Automatically calculates frame distribution based on your input, saving you time and effort.
  • Global Prompt Field: This feature allows you to set persistent details that apply across the entire video, such as style or character descriptions. If left empty, the first segment's text is used as the global anchor.
  • Normalize by Tokens: When enabled, this option adjusts the weight of each segment based on the number of CLIP tokens, ensuring that segments with more content receive more frames.

These features can be customized to suit your specific needs, allowing for a high degree of flexibility in how you create and manage your video content.

ComfyUI-PromptRelay Models

Currently, ComfyUI-PromptRelay does not include different models. The extension focuses on providing a streamlined process for frame distribution and prompt management, making it accessible and easy to use for artists without requiring model selection.

What's New with ComfyUI-PromptRelay

As ComfyUI-PromptRelay is a work in progress, updates and improvements are continually being made to enhance its functionality and user experience. While specific version updates are not detailed here, you can expect ongoing enhancements that aim to make the extension more intuitive and powerful for AI artists.

Troubleshooting ComfyUI-PromptRelay

If you encounter issues while using ComfyUI-PromptRelay, here are some common problems and solutions:

  • Problem: Segments are not distributed as expected.
  • Solution: Double-check your syntax for any errors. Ensure that you are using either the Inline or Block syntax correctly and that weights or ranges are specified properly.
  • Problem: The global prompt is not being applied.
  • Solution: Make sure the global_prompt field is set correctly. If left empty, verify that the first segment contains the desired global details.
  • Problem: Unexpected frame distribution with normalize_by_tokens enabled.
  • Solution: Review the content of each segment to ensure that the token count aligns with your expectations. Adjust the segment content if necessary.

Learn More about ComfyUI-PromptRelay

To further explore the capabilities of ComfyUI-PromptRelay, consider visiting the original project page here. This resource provides additional insights and examples that can help you make the most of the extension. Additionally, engaging with community forums and online tutorials can offer valuable support and inspiration as you work on your projects.

ComfyUI-PromptRelay Related Nodes

RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.