Command Line Options¶
Visionatrix supports a range of command-line options to manage installation, updating, execution, and configuration of the application. These options combine Visionatrix-specific functionality with many of the command-line features inherited from ComfyUI. Note that for some settings, values stored in the database or provided via environment variables take precedence over command-line arguments.
Global Options¶
--verbose [LEVEL]
: Set the logging level. Choices:DEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
Note: This option should be specified before the command.
Commands Overview¶
Visionatrix provides the following commands:
- install: Performs cleanup and initialization.
- update: Updates Visionatrix to the latest version.
- run: Starts Visionatrix.
- install-flow: Installs a flow by name, tag, or from a file.
- create-user: Creates a new user.
- orphan-models: Removes orphan models.
- openapi: Generates OpenAPI specifications.
- list-global-settings: Lists all global settings.
- get-global-setting: Retrieves a specific global setting.
- set-global-setting: Creates or updates a global setting.
Note: In previous versions, options such as
--comfyui_dir
could be used to specify the ComfyUI directory. In the current version, directory paths (e.g.COMFYUI_DIR
,BASE_DATA_DIR
) are determined by the database settings and environment variables. To override these, update the corresponding global settings or environment variables.
The run
Command¶
Starts the Visionatrix application, enabling both task processing and (optionally) the web user interface.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] run [options]
Visionatrix-Specific Options¶
-
--host=HOST
: Host to listen on (DEFAULT or SERVER mode).Info
This corresponds to ComfyUI's
--listen
argument. -
--port=PORT
: Port number to bind to (used in DEFAULT or SERVER mode). --server=SERVER_ADDRESS
: Address of the Vix Server (used in WORKER mode).-
--mode {DEFAULT,WORKER,SERVER}
: Visionatrix operating mode. -
--ui [UI_DIR]
: Enables the web user interface. - When provided without a value, the default UI is enabled.
- When provided with a directory, it specifies a custom UI.
--disable-device-detection
: Disables automatic device detection.
Additionally, ComfyUI-specific options (except those unsupported) can be passed; these will be forwarded to ComfyUI. Unsupported ComfyUI options include:
- --tls-keyfile
- --tls-certfile
- --enable-cors-header
- --verbose
(use Visionatrix’s --verbose
instead)
- --dont-print-server
- --quick-test-for-ci
- --windows-standalone-build
- --auto-launch
- --disable-auto-launch
- --multi-user
(Visionatrix always supports multiple users)
The install
Command¶
Performs a clean installation by removing existing flows and reinstalling ComfyUI and related components.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] install
During installation, if a ComfyUI folder is already present, you will be prompted to confirm its removal.
The update
Command¶
Updates components such as ComfyUI, ComfyUI-Manager and custom nodes to the pinned versions that comes with this version of Visionatrix.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] update
The install-flow
Command¶
Installs a flow by specifying a file, flow name, or flow tag. This command is particularly useful in environments without a user interface.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] install-flow [options]
Options¶
You must provide one of the following:
--file=FILE_PATH
: Path to acomfyui_flow.json
file or a directory containing flow files.--name=FLOW_NAME
: A flow name mask to identify flows by their ID.--tag=TAG
: A flow tag mask to identify flows by tag.
The create-user
Command¶
Creates a new user in the Visionatrix system.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] create-user [options]
Options¶
--name=USERNAME
(required): User ID.--password=PASSWORD
(required): User password.--full_name=FULL_NAME
: Full name of the user. Default:John Doe
--email=EMAIL
: User's email address. Default:user@example.com
--admin=BOOLEAN
: Whether the user should be an administrator. Default:True
--disabled=BOOLEAN
: Whether the account should be disabled. Default:False
The orphan-models
Command¶
Removes orphan models that are no longer needed by the system.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] orphan-models [options]
Options¶
--no-confirm
: Do not prompt for confirmation for each model.--dry-run
: Execute a trial run without actually removing models.--include-useful-models
: Include orphaned models that may be useful for future flows.
The openapi
Command¶
Generates OpenAPI specifications for the Visionatrix API, covering endpoints for flows and other features.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] openapi [options]
Options¶
--file=FILENAME
: Output filename for the OpenAPI specification. Default:openapi.json
--indentation=SIZE
: Indentation size for the generated JSON. Default:2
--flows=FLOWS
: Comma-separated list of flows to include in the spec.- Use
*
to include all flows. - An empty string (e.g.,
--flows=""
) will exclude flows. --skip-not-installed
: Skip flows that are not installed. Default: Enabled.--exclude-base
: Exclude base application endpoints from the specification.
Global Settings Commands¶
Visionatrix allows you to manage global settings directly from the command line.
The list-global-settings
Command¶
Lists all global settings stored in the database.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] list-global-settings
This command displays each setting in the following format:
- setting_name = "value"
The get-global-setting
Command¶
Retrieves the value of a specific global setting.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] get-global-setting --key=SETTING_NAME
The set-global-setting
Command¶
Creates or updates a global setting.
Syntax¶
python3 -m visionatrix [--verbose=LEVEL] set-global-setting --key=SETTING_NAME --value=VALUE [--sensitive]
- The
--sensitive
flag marks the setting as sensitive (hiding it from non-admin users).
Examples¶
Running Visionatrix with Custom Options¶
Start Visionatrix in SERVER mode on a specific host and port with the default Web UI:
python3 -m visionatrix --verbose=WARNING run --host=0.0.0.0 --port=8000 --ui
Running Visionatrix in WORKER Mode¶
Connect a worker instance to a Vix Server:
python3 -m visionatrix --verbose=INFO run --mode WORKER --server=http://your_vix_server_address
Installing a Flow from a File¶
Install a flow by providing the path to a flow JSON file:
python3 -m visionatrix install-flow --file=/path/to/comfyui_flow.json
Creating a New User¶
Create a new administrator user:
python3 -m visionatrix create-user --name=admin --password=secret --email=admin@example.com
Removing Orphan Models¶
Perform a dry-run cleanup of orphan models without confirmation prompts:
python3 -m visionatrix orphan-models --no-confirm --dry-run
Generating OpenAPI Specifications¶
Generate an OpenAPI specification that includes all flows:
python3 -m visionatrix openapi --flows="*" --file=openapi.json
Listing Global Settings¶
Display all global settings:
python3 -m visionatrix list-global-settings
Retrieving a Specific Global Setting¶
Retrieve the value of a global setting:
python3 -m visionatrix get-global-setting --key=comfyui_folder
Setting a Global Setting¶
Update or create a global setting (marking it as sensitive if needed):
python3 -m visionatrix set-global-setting --key=comfyui_folder --value=/new/path/to/ComfyUI --sensitive