Skip to content

Commit a3ba930

Browse files
author
ryanontheinstide
committed
2 parents 747f03f + 40197c1 commit a3ba930

File tree

3 files changed

+74
-33
lines changed

3 files changed

+74
-33
lines changed

.github/workflows/publish.yml

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
name: Publish to Comfy registry
2+
on:
3+
workflow_dispatch:
4+
push:
5+
branches:
6+
- main
7+
- master
8+
paths:
9+
- "pyproject.toml"
10+
11+
jobs:
12+
publish-node:
13+
name: Publish Custom Node to registry
14+
runs-on: ubuntu-latest
15+
# if this is a forked repository. Skipping the workflow.
16+
if: github.event.repository.fork == false
17+
steps:
18+
- name: Check out code
19+
uses: actions/checkout@v4
20+
- name: Publish Custom Node
21+
uses: Comfy-Org/publish-node-action@main
22+
with:
23+
## Add your own personal access token to your Github Repository secrets and reference it here.
24+
personal_access_token: ${{ secrets.REGISTRY_ACCESS_TOKEN }}

README.MD

Lines changed: 35 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,37 @@
1-
# ComfyUI Control Nodes
1+
# ComfyUI Real-Time Nodes ⏱️
22

3-
Control nodes that generate changing values over separate executions of a workflow. Each time the workflow is executed, the value will be updated. This is useful for animating parameters in systems like [ComfyStream](https://github.com/yondonfu/comfystream) that execute the workflow once per frame.
3+
A growing suite of nodes for real-time ComfyUI workflows. Features include value animation, motion detection and tracking, sequence control, and more. These nodes update their outputs on each workflow execution, making them perfect for real-time applications like [ComfyStream](https://github.com/yondonfu/comfystream) that execute the workflow once per frame.
4+
5+
The intention for this repository is to build a suite of nodes that can be used in the burgeoning real-time diffusion space. Contributions are welcome!
46

57
## Nodes
68

7-
### Value Controls
9+
### Value Controls 🎚️
810
- **FloatControl**: Outputs a floating point value that changes over time using various patterns (sine wave, bounce, random walk, etc).
911
- **IntControl**: Same as FloatControl but outputs integer values.
1012
- **StringControl**: Cycles through a list of strings using the same movement patterns.
1113

12-
### Sequence Controls
14+
### Sequence Controls 📽️
1315
- **FloatSequence**: Cycles through a comma-separated list of float values.
1416
- **IntSequence**: Cycles through a comma-separated list of integer values.
1517
- **StringSequence**: Cycles through a list of strings (one per line).
1618

17-
### Motion Controls
19+
### Motion Controls 🎮
1820
- **MotionController**: Advanced float-based motion control for smooth animations.
1921
- **IntegerMotionController**: Integer-based motion control for discrete value animations.
2022
- **ROINode**: Region of Interest node for motion tracking and control.
2123

22-
### Utility Controls
24+
### Utility Controls 🛠️
2325
- **FPSMonitor**: Generates an FPS overlay as an image and mask, useful for monitoring performance.
2426
- **QuickShapeMask**: Rapidly generate shape masks (circle, square) with customizable dimensions.
2527
- **DTypeConverter**: Convert masks between different data types (float16, uint8, float32, float64).
2628
- **FastWebcamCapture**: High-performance webcam capture node with resizing capabilities.
2729

28-
### VAE Tools
30+
### VAE Tools 🖼️
2931
- **TAESDVaeEncode**: TAESD VAE encoding node.
3032
- **TAESDVaeDecode**: TAESD VAE decoding node.
3133

32-
## Movement Patterns
34+
## Movement Patterns 🔄
3335

3436
All value and motion controls support various movement patterns:
3537
- **Sine**: Smooth sinusoidal motion
@@ -39,7 +41,7 @@ All value and motion controls support various movement patterns:
3941
- **Static**: No movement (constant value)
4042
- **and more**
4143

42-
## Usage
44+
## Usage 📖
4345

4446
### Value Controls
4547
Connect any value control node to the input of the node you want to animate. These nodes use movement patterns like sine, bounce, etc. to smoothly transition between values.
@@ -59,27 +61,27 @@ Sequence controls allow you to specify exact values to cycle through. You can co
5961
### FPS Monitor
6062
Outputs an image and mask showing current and average FPS. Useful for performance monitoring in real-time workflows.
6163

62-
## Examples
64+
## Examples 🎬
6365

6466
### Value Control Demo
65-
In this demo we are controlling the width and height of a shape mask with an Int Control node:
67+
In this demo we are controlling the width and height of a shape mask with an Int Control node. Imagine controlling the denoise on a KSampler with a Float Control, though! Or CFG in StreamDiffusion!
6668
![Value Control Demo](assets/ValueControl.gif)
6769

68-
### Motion Active Blur Demo
69-
Example of motion-based active blur effect:
70+
### Motion Detection Blur Demo
71+
Example of motion-based active blur effect running in ComfyStream. The action here is to control the blur amount of the frame here, but imagine if the action was "fire weapon":
7072
![Motion Active Blur Demo](https://github.com/user-attachments/assets/e2a7a5e2-651a-4b0d-b3f9-12cb40acce04)
7173

72-
## Installation
74+
## Installation 💻
7375

74-
### Option 1: ComfyUI Manager (Coming soon!!)
75-
~~The easiest way to install is through [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager):~~
76-
~~1. Install ComfyUI Manager if you haven't already~~
77-
~~2. Open ComfyUI~~
78-
~~3. Navigate to the Manager tab~~
79-
~~4. Search for "Control Nodes"~~
80-
~~5. Click Install~~
76+
### Option 1: ComfyUI Manager 📦
77+
The easiest way to install is through [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager):
78+
1. Install ComfyUI Manager if you haven't already
79+
2. Open ComfyUI
80+
3. Navigate to the Manager tab
81+
4. Search for "Control Nodes"
82+
5. Click Install
8183

82-
### Option 2: Manual Installation
84+
### Option 2: Manual Installation ⚙️
8385
1. Clone this repository into your ComfyUI custom_nodes folder:
8486
```bash
8587
cd ComfyUI/custom_nodes
@@ -92,9 +94,9 @@ cd ComfyUI_RealTimeNodes
9294
pip install -r requirements.txt
9395
```
9496

95-
## Coming Soon
97+
## Coming Soon 🚀
9698

97-
### Advanced Detection System
99+
### Advanced Detection System 👁️
98100
The next major update will introduce a comprehensive detection system with multiple detector types:
99101
- **Motion Detection**: Enhanced motion detection with configurable sensitivity and regions
100102
- **Object Detection**: Real-time object detection and tracking
@@ -104,24 +106,24 @@ The next major update will introduce a comprehensive detection system with multi
104106

105107
These detection systems will provide powerful inputs for real-time ComfyUI workflows, enabling dynamic responses to various types of detected changes in the input stream.
106108

107-
## Project Status
109+
## Project Status 📊
108110

109111
This is an evolving project that aims to expand the real-time capabilities of ComfyUI. As real-time use cases for ComfyUI continue to emerge and grow, this project will adapt and expand to meet those needs. The goal is to provide a comprehensive suite of tools for real-time workflows, from simple value animations to complex detection and response systems.
110112

111-
### Contributing
113+
### Contributing 🤝
112114

113115
Your feedback and contributions are more than welcome! This project grows stronger with community input.
114116

115-
- Have an idea? Open an issue!
116-
- Found a bug? Open an issue!
117-
- Made an improvement? Submit a PR!
118-
- Want to help? Join the discussion!
117+
- Have an idea? Open an issue! 💡
118+
- Found a bug? Open an issue! 🐛
119+
- Made an improvement? Submit a PR! 🎉
120+
- Want to help? Join the discussion! 💬
119121

120122
Please visit our [GitHub Issues](https://github.com/ryanontheinside/ComfyUI_RealTimeNodes/issues) page to contribute.
121123

122-
## Related Projects
124+
## Related Projects 🔗
123125

124-
### ComfyUI_RyanOnTheInside - Everything Reactivity
126+
### ComfyUI_RyanOnTheInside - Everything Reactivity
125127
Make anything react to anything in your ComfyUI workflows. [ComfyUI_RyanOnTheInside](https://github.com/ryanontheinside/ComfyUI_RyanOnTheInside) - my main custom nodes suite that brings complete reactive control to standard ComfyUI workflows:
126128

127129
- Dynamic node relationships
@@ -137,4 +139,4 @@ Make anything react to anything in your ComfyUI workflows. [ComfyUI_RyanOnTheIns
137139
- Reactive DepthFlow
138140
- Actually more
139141

140-
Use it alongside these Control Nodes to master both the batch and real-time paradigms in ComfyUI.
142+
Use it alongside these Control Nodes to master parameter control in both the batch and real-time paradigms in ComfyUI! The POWER!!

pyproject.toml

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
[project]
2+
name = "comfyui_realtimenodes"
3+
description = "These nodes are for real-time applications of ComfyUI."
4+
version = "1.0.0"
5+
license = {file = "LICENSE"}
6+
dependencies = ["opencv-python"]
7+
8+
[project.urls]
9+
Repository = "https://github.com/ryanontheinside/ComfyUI_RealTimeNodes"
10+
# Used by Comfy Registry https://comfyregistry.org
11+
12+
[tool.comfy]
13+
PublisherId = "ryanontheinside"
14+
DisplayName = "ComfyUI_RealTimeNodes"
15+
Icon = "⏱️"

0 commit comments

Comments
 (0)