ComfyUI to Visionatrix migration
+If you want to adopt your ComfyUI workflow to use in Visionatrix, +you can use this guide to help you do so. There are a few steps you need to follow.
+1. Install ComfyUI-Visionatrix custom nodes
+First, it is recommended to install our custom ComfyUI-Visionatrix nodes. +Otherwise you will have to use custom nodes titles which are will be parsed by Visionatrix.
+git clone https://github.com/Visionatrix/ComfyUI-Visionatrix.git
+
Note
+You can do the required migration via nodes titles, which is less convenient.
+The node title must be like this: input;Display Name;optional;advanced;order=1;custom_id=custom_name
.
2. Define the input params
+Visionatrix UI aims simplicity and clarity. +Define the most important input params of your ComfyUI workflow to extract +them to the Visionatrix UI as inputs, for example:
+-
+
prompt (textarea)
+negative prompt (textarea)
+prompt strength (range)
+some logic toggles (checkbox)
+input files (file)
+
For that you will need to attach our custom nodes as adapters to your nodes receiving these inputs +that are will be filled by the user from the Visionatrix UI.
+As example, you can have a look at our list of worklows adopted to the new format.
+Note
+The list of available nodes can be found in the readme of the ComfyUI-Visionatrix repository.
+2.1 Node to Input mapping via title string
+Alternatively, Visionatrix supports other Nodes mapping as an input param +via node title string separated by semicolon.
+++The nodes titles starting with
+input;
keyword are considered as +Visionatrix input param.
The parameters list:
+-
+
input
- keyword to define the input param
+Display Name
- positional parameter, the name of the input field displayed in the UI
+optional
- if present, the optional field is set to True
+advanced
- if present, the advanced field is set to True
+order=1
- the order of the input param in the UI
+custom_id=custom_name
- the custom id of the input param
+
Note
+order
is important if workflow accepts more than 1 file.
2.2 External nodes used via Node to Input mapping
+In our workflows, we use some external nodes mapped as input params, that you can use as example:
+-
+
SDXLAspectRatioSelector
- select input field used from comfyui-art-venture for Aspect Ratio select. Usually it’s an optional and hidden to the advanced prompt options:input;Aspect Ratio;optional;advanced;custom_id=aspect_ratio
;
+LoadImage
- default ComfyUI image loader node as image file input field. As required title:input;Input image;order=1
, or optional advanced:input;Optional helper image;optional;advanced;order=20
;
+
3. Map the models for automatic download
+Visionatrix simiplifies and automates the process of downloading the models. +As the third step of the migration, you need to map the models that are used in your workflow (see Automatic models mapping).
+4. Build the list of available flows
+The last step is to build the list of available flows in the Visionatrix UI.
+Follow the steps described in options.py file
+for FLOWS_URL
and MODELS_CATALOG_URL
to enable Visionatrix local workflows development mode:
Create a zip with adjusted/new flows:
+cd ../VixFlowsDocs && zip -r ../Visionatrix/flows.zip flows && cd ../Visionatrix
+
And uncomment appropriate code lines in options.py file to use local versions of the flows.
+5. Verify and test the workflow
+Last step is to run Visionatrix and setup your workflow to verify that everything works as expected.
+