https://github.com/IgalOgonov/ComfyUI_Simple_String_Repository
Custom ComfyUI node that allows storing and accessing strings, meant to be parts of a prompt, in a simplified manner. Partially supports dynamic prompt syntax.
https://github.com/IgalOgonov/ComfyUI_Simple_String_Repository
Last synced: 4 months ago
JSON representation
Custom ComfyUI node that allows storing and accessing strings, meant to be parts of a prompt, in a simplified manner. Partially supports dynamic prompt syntax.
- Host: GitHub
- URL: https://github.com/IgalOgonov/ComfyUI_Simple_String_Repository
- Owner: IgalOgonov
- License: mit
- Created: 2024-12-27T13:34:24.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-12-27T23:05:21.000Z (4 months ago)
- Last Synced: 2024-12-28T00:16:50.736Z (4 months ago)
- Language: Python
- Homepage:
- Size: 5.19 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-comfyui - **Simple String Repository**
README
# ComfyUI_Simple_String_Repository
A small utility node (in multiple variations) which assists prompt building by allowing you to use "quick and dirty" collections of strings, separated via new-line and indexed inside the string itself, directly in ComfyUI - as opposed to loading from massive collections of external files.
The nodes also support basic "randomness" syntax, which is explained in the [sd dynamic prompts repo](https://github.com/adieyal/sd-dynamic-prompts).
However, unlike the dynamic prompts in the above repo, this node aims at helping you build prompts faster using many small collections of strings already relevant to your specific project / workflow, as opposed to exploring different combinations of random elements from massive lists.
This is better illustrated below.
Install
-----------------------------------------------------------------------------
**Option 1**
Install via [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager) - [ComfyUI Registry Page](https://registry.comfy.org/publishers/io/nodes/comfyui_simple_string_repository).
**Option 2**
Clone the repository into your ComfyUI custom_nodes directory.
```text
git clone https://github.com/IgalOgonov/ComfyUI_Simple_String_Repository
```
The Node(s)
-----------------------------------------------------------------------------
The nodes are all called "Simple String Repository".
The there are three **variations** based on the number of potentially selected strings (`Small` for 3, no suffix for 5, and `Large` for 10), and each node has a "compact" version which is worse for automated workflow but more comfortable if you intend to set all selection parameters (1 required, 2 optional) manually.
Each node has the `string` input, which corresponds to the collection of strings you wish to use.
By design, each collection should represent alternative tags belonging to the same "group", e.g. art styles, type of atmosphere, color scheme, artist, etc.
Below is the `delimiter`, used to separate multiple outputs in case you select more than one strings from the collection.
Afterwards is where the `Compact` and `Regular` nodes differ.
In regular node, each `target` (the index of the sub-string you wish to select) has three relevant widgets:
* The index itself (`target`)
* Its strength (`strength`)
* In case of a collection of randomly interchangeable strings, as explained in the [sd dynamic prompts repo](https://github.com/adieyal/sd-dynamic-prompts), you may explicitly select one of the options via `random` (index starts at 0), or leave it at `-1` for a random output.
The `Compact` nodes simply shove all three parameters into a single `,`-separated string. All optional parameters can be omitted.
The **indexes** are highly **recommended**, but **optional**.
Any string that does not have an index will get assigned its line number as an index during runtime.
When duplicate indexes exist (typically, this would only happen because of a mess caused by mixing indexed and unindexed strings), only the first one can be selected.
The **front-end functionality** helps avoid that:
1. `Add Missing Indexes` - This button will add unique numerical indexes to any strings missing them. Will also fix duplicates, but replacing any duplicate identifier with a new one.
The new indexes are always the lowest available unique index.
Good for when you already have specific automated workflows reliant on specific numbers, but overall, this is considered a quick and dirty fix.
2. `Regenerate All Indexes` - Strips all strings from their existing indexes, then assigns new ones, based on the line number.
3. `Remove All Indexes` - Strips all strings from their indexes.
4. `Reset Target Parameters` Resets the selection parameters, making the output blank.
Intended Usage
-----------------------------------------------------------------------------
Those nodes don't really have much functionality by themselves - they are meant to supplement existing prompt builder nodes, such as [String Function Tree](https://github.com/wolfden/ComfyUi_String_Function_Tree), that are meant for prompt building (as opposed to prompt generation / random exploration).
The collections themselves can be created manually (e.g. explore articles about art styles relevant to your project, and copy-paste relevant styles into an "Art Styles" node), or you can take subsets from existing collections [like the ones over here](https://github.com/adieyal/sd-dynamic-prompts/tree/main/collections).
As you may have noticed from the earlier preview, the node does support the basic randomness syntax (e.g. `{something|like|this}`), although it's not optimized for it.
Note that you don't have to use short strings - you may also use large collections as a single string, as long as you're fine with giving up precision for such strings.