Fooocus is designed to get out of the way of installation. On Windows, the entire process is a single download, a single extraction, and a double-click — no Python environment setup, no manual model downloads, and no configuration files to edit before your first generation. Linux, macOS, and Docker paths require a few more steps, but each platform follows a straightforward script-based workflow that handles model downloads automatically on first launch.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/lllyasviel/Fooocus/llms.txt
Use this file to discover all available pages before exploring further.
Minimum Hardware Requirements
The table below lists the minimum specifications required to run Fooocus locally on each supported platform. Devices below these specs may not be able to run the software.| Operating System | GPU | Min. GPU Memory | Min. System RAM | System Swap | Notes |
|---|---|---|---|---|---|
| Windows / Linux | Nvidia RTX 4XXX | 4 GB | 8 GB | Required | Fastest |
| Windows / Linux | Nvidia RTX 3XXX | 4 GB | 8 GB | Required | Usually faster than RTX 2XXX |
| Windows / Linux | Nvidia RTX 2XXX | 4 GB | 8 GB | Required | Usually faster than GTX 1XXX |
| Windows / Linux | Nvidia GTX 1XXX | 8 GB (6 GB uncertain) | 8 GB | Required | Only marginally faster than CPU |
| Windows / Linux | Nvidia GTX 9XX | 8 GB | 8 GB | Required | Faster or slower than CPU |
| Windows / Linux | Nvidia GTX < 9XX | Not supported | — | — | — |
| Windows | AMD GPU | 8 GB | 8 GB | Required | Via DirectML; ~3× slower than Nvidia RTX 3XXX |
| Linux | AMD GPU | 8 GB | 8 GB | Required | Via ROCm; ~1.5× slower than Nvidia RTX 3XXX |
| Mac | M1 / M2 MPS | Shared | Shared | Shared | ~9× slower than Nvidia RTX 3XXX |
| Windows / Linux / Mac | CPU only | 0 GB | 32 GB | Required | ~17× slower than Nvidia RTX 3XXX |
AMD GPU support on Windows uses DirectML. ROCm support on Windows is currently on hold. AMD support on all platforms is considered beta and is not intensively tested.
Platform Installation Guides
Windows
One-click
.7z download with embedded Python. No existing Python installation required.Linux
Anaconda, Python venv, or native system Python. AMD ROCm instructions included.
macOS
Runs via PyTorch MPS on Apple M1/M2 silicon with macOS Catalina or newer.
Docker
Containerised deployment. See the project’s
docker.md for full compose configuration.Default Models
Fooocus ships three preset configurations, each using a different checkpoint optimised for a different output style. The correct model is selected automatically based on which launcher or--preset flag you use.
| Preset | Windows Launcher | Linux / CLI Flag | Main Model | Refiner |
|---|---|---|---|---|
| General (default) | run.bat | (none) | juggernautXL_v8Rundiffusion.safetensors | Not used |
| Realistic | run_realistic.bat | --preset realistic | realisticStockPhoto_v20.safetensors | Not used |
| Anime | run_anime.bat | --preset anime | animaPencilXL_v500.safetensors | Not used |
Model downloads are automatic. When you launch Fooocus for the first time with a given preset, the required checkpoint is downloaded directly to
Fooocus\models\checkpoints. If you already have the files, copy them to that folder before launching to skip the download. If inpainting is used for the first time, an additional 1.28 GB inpaint patch (inpaint_v26.fooocus.patch) is downloaded automatically to Fooocus\models\inpaint.Switching Presets After Launch
Starting with Fooocus 2.3.0, you can switch between presets directly in the browser UI without restarting the application. Two optional flags control this behavior:Corrupted Model Files
If you see errors likeMetadataIncompleteBuffer or PytorchStreamReader at launch, your model files are corrupted. Delete the affected .safetensors file and relaunch Fooocus to trigger a fresh automatic download.