Tutorials for the cloud node please :)

stephantual commented 10 months ago

With all the good will in the word (and you know I love your work) - i can' wrap my head around 'hub' and now the new 'cloud' node. ANY tutorial, even a video on YT without sound with a simple worfklow woud be useful at this point.

Thank you for your undertanding!

Trung0246 commented 9 months ago

Technically I did have a example workflow in the README ;)

But honestly the feature set for the "Cloud" node is kinda poor right now with only a couple of basic prompt manipulation functionality and currently mainly deal with raw text/prompt. It basically a personal node that made public since I don't like typing. Conveniently it support other stuff like randomize/sequencing words and merging other cloud nodes.

So here's some very bare bone docs 😅

In the workflow you can pick a "cloud object" by clicking on it then hold Shift to drag it to desired location.

https://github.com/Trung0246/ComfyUI-0246/assets/11626920/7badb3df-7f45-4191-9a32-9525db388715

Clicking in a cloud object will reveal related widgets which can be changed OR convert to a input just a typical comfy widget.

Hold left click to empty space of the main widget then drag mouse over will reveal the group id that are associated with each "cloud object".

All cloud nodes should be paired with "0246.Stringify" to convert then to the final prompt.

Right clicking on the node itself will reveal more stuff:

🗑️ Picked Clouds: delete all picked "cloud".
✔️ All Clouds: pick all "cloud".
🗑️ Unpick All Clouds.
✔️ first_group_id ➡️ Picked Clouds: assign group from first_group_id to all picked clouds.
🗑️ second_group_id ➡️ Picked Clouds: unassign group from second_group_id to all picked clouds.
✔️ first_group_id ➡️ second_group_id: assign all nodes (with group second_group_id) with first_group_id.
🗑️ first_group_id ➡️ second_group_id: unassign first_group_id with all nodes that have group second_group_id).
✔️ Cloud ➡️ 🗑️ Preview: Supposed to convert all "cloud objects" to text format but feels like it useless since 0246.Beautify already showing the final prompt so not implemented yet.
✔️ Preview ➡️ 🗑️ All Clouds: Convert the entire text within preview to multiple "cloud object". Optionally can be specified on how to read the prompt using regex but for now that pop-up regex doesn't do anything.
- This is very bare bone and only support the exact format of something like masterpiece, (beautiful: 1.25) and very dependent on how comfy.sd1_clip.parse_parentheses parsing the prompt.
✔️ Preview ➡️ Cloud: Supposed to convert the entire text within preview to a single "cloud object" (not implemented yet).

https://github.com/Trung0246/ComfyUI-0246/assets/11626920/5620a011-2187-4dc1-831e-514702283744

So there's current 5 different type of "cloud object":

text
- Basic text object.
weight
- For all text object that are associated with this weight object (by using ✔️ first_group_id ➡️ Picked Clouds and verifying that the text object and weight object have same group id).

rand
- For all text object that are associated with this rand object, it will randomly pick certain cloud based on seed, count, order and mode.
- seed
  - Well it just that, seed for replicable outputs.
- count
  - How many cloud object should be returned.
- order
  - false to ignore order, true will attempt to keep original relative order.
- mode
  - seed
    - Generate new seed since I don't want a separate widget to do this.
  - fix
    - Fixed replicable generation with same seed.
  - rand
    - Same seed will retain across prompt execution but internally will do just that and randomize things based on the seed.
  - add, sub
    - Increase or decrease the seed value.

https://github.com/Trung0246/ComfyUI-0246/assets/11626920/260ffa44-89d1-4b9d-8a80-7fda3db449b7

Notice that a cloud object can have multiple group id and make things like only apply weight to exact text object like dfg and therefore cloud object order is important (since it is topologically sorted).

cycle
- For all text object that are associated with this cycle object, it will sequentially pick certain cloud based on offset, count, order and mode.
- offset
  - No need to explain :)
- step
  - Basically offset + step for each prompt queue execution.
- space
  - Only relevant if count >= 2. Basically offset + step + (space * count).
- count
  - How many associated cloud objects should be returned.

https://github.com/Trung0246/ComfyUI-0246/assets/11626920/5e44b63b-dfc0-4300-ae97-f63e93c4eaa1

Even better cycle and rand can be associated with weight or merge for that "nested" effect.

merge

pin
- Cannot be created manually. You can see why.

https://github.com/Trung0246/ComfyUI-0246/assets/11626920/99a9dfff-9e96-4739-bd66-c3f2fa8d82a4

Bonus stuff that related to widget inputs. Currently the type must be converted to *. Did not test how CastReroute would handle this by picking * so there's that.

https://github.com/Trung0246/ComfyUI-0246/assets/11626920/72e6e50d-be96-40a6-a133-b9d5bb1f6339

Since this node technically still in beta I may change the cloud object names to something else and could cause breakage but I could theoretically migrate automatically with JS stuff.

With the future topological execution pull, rand and cycle could execute multiple times within a single loop with a single prompt queue.

Planned features:

Load text directly from files such as style.csv or style.json and allowing to pick specific stuff from there.

stephantual commented 9 months ago

Thank you so much, this is great!

Trung0246 / ComfyUI-0246

Tutorials for the cloud node please :) #24