Skip to content

Command Line Arguments

Jump to bottom
David Sage edited this page Oct 10, 2025 · 41 revisions
Startup Batch File - Flux1Krea8

Startup Batch Files

FooocusPlus has two methods for adjusting the startup configuration, config.txt and command line arguments. The GPU‐Type, Torch & the Command Line Wiki article discusses the basics of command line arguments in FooocusPlus startup batch files.

In cases where the same option is duplicated in both config.txt and the command line arguments, likely the argument method will be removed in the future. Command line arguments can rapidly become overwhelming if several are present in a startup batch file. We will likely continue the trend that started in original Fooocus of moving arguments to config.txt where it makes sense to do so.

The FooocusPlus/UserDir/batch_startups directory has a collection of these startup files, including those for several languages, custom presets (as shown in the attachment above) and technical configurations.

This attachment shows a custom welcome image on a typical startup screen for the --preset Flux1Krea_8GGUF argument (as included in run_Flux1Krea8.bat).

Flux1Krea Startup Screen

Command Line Arguments Detailed

As listed below, there are many more options available. The majority of them are used rarely, if ever, so only the most popular arguments are explained.

  • --user-dir - this specifies the location of the user directory. It defaults to FooocusPlus/UserDir

  • --config - the location of config.txt. By default it is found in FooocusPlus/UserDir

  • --models-root - the primary location for generative AI models. Typically set by the config.txt "path_models_root" option.

  • --temp-path - the location for temporary image files. Also set by config.txt "temp_path". Arguments always take priority.

  • --output-path - the storage location for generated images. This can also be set with the config.txt "path_outputs" option.

  • --disable-metadata - do not save metadata info. to images. Also set by config.txt "default_save_metadata_to_images"

  • --language - set to any of the two letter codes in the Language Pack Codes table. Defaults to "en" (US English).

  • --hf-mirror - an alternate source for Hugging Face downloads, for use in East Asia. Set to https://hf-mirror.com/ to activate.

  • --preset - start FooocusPlus with a specific preset.

  • --disable-preset-selection - do not allow presets to be changed in the user interface (UI).

  • --always-download-new-model - allow presets to download new models when required.

  • --disable-preset-download - prevent presets from downloading new models.

  • --theme - launch FooocusPlus with a light or dark theme. Defaults to dark.

The attachment below show the startup batch file for the Portuguese language, which includes the --language pt argument.

Startup Batch File - Portuguese

Technical Arguments

  • --always-offload-from-vram - unload video memory (VRAM) whenever possible. May be needed if there is limited VRAM.

  • --disable-offload-from-vram - operate in Smart Memory mode: VRAM will be unloaded only when necessary.

  • --gpu-type - overrides automatic detection of the video interface. See GPU Type for details.

  • --gpu-device-id - sets the device ID if you have more than one NVIDIA GPU.

  • --directml - specifies the device ID for DirectML compatible GPUs, if you have more than one.

  • --disable-attention-upcast - reduces stability during attention calculations. Only used for debugging.

  • --disable-ipex-hijack - an option used with some Intel XPUs.

  • --disable_server_info - used with external images in ldm_patched, function unknown.

  • --disable-xformers - disable the xformers library for debugging purposes. Rarely used.

  • --pytorch-deterministic - can produce identical results but reduces image generation speed.

  • --vae-in-cpu - reduces VRAM usage but significantly slows down image generation.

  • --dev - use the developer branch, if available. FooocusPlus typically does not deploy a developer branch.

  • --disable-comfyd - prevent FooocusPlus from using Comfy.

  • --in-browser - these two browser related arguments determine whether FooocusPlus will use a user interface.

  • --disable-in-browser - either or both of these browser arguments may be removed in the future.

  • --rebuild-hash-cache - generates missing model and LoRA hashes. This is normally an automatic function.

This attachment demonstrates the Portuguese user interface, activated by the --language pt argument (included in run_FooocusPlus_Português.bat).

Portuguese User Interface

Seven Mutually Exclusive Technical Sets

Only one item in each group can be active.

--all-in-fp16
--all-in-fp32

--attention-pytorch
--attention-quad
--attention-split

--async-cuda-allocation
--disable-async-cuda-allocation

--clip-in-fp8-e4m3fn
--clip-in-fp8-e5m2
--clip-in-fp16
--clip-in-fp32

--unet-in-fp8-e4m3fn
--unet-in-fp8-e5m2
--unet-in-bf16
--unet-in-fp16

--vae-in-bf16
--vae-in-fp16
--vae-in-fp32

--always-cpu
--always-gpu
--always-high-vram
--always-normal-vram
--always-low-vram
--always-no-vram

Clone this wiki locally