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 paramDisplay Name
- positional parameter, the name of the input field displayed in the UIoptional
- if present, the optional field is set to Trueadvanced
- if present, the advanced field is set to Trueorder=1
- the order of the input param in the UIcustom_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.