Fooocus in 2026: Setup, Status, and Alternatives

Fooocus is the simplest path from "I want beautiful images" to actually having them. lllyasviel built it as the opinionated antidote to the parameter-overload of A1111 and ComfyUI: opinionated SDXL defaults, automatic prompt expansion, curated style presets, and one-click "Speed / Quality / Extreme Speed" performance modes. Type a short prompt, click Generate, get a polished image. No sampler dropdowns, no CFG sliders, no negative prompt required.

For everyone who is not a Stable Diffusion power user — photographers exploring AI, content creators on deadlines, designers prototyping concepts, hobbyists generating wallpaper — Fooocus is the right starting point. This guide covers everything: installation, the simplified UI, performance presets, style system, image prompt and inpainting, LoRA / checkpoint management, the maintained mashb1t fork, and where Fooocus does or doesn't fit. Updated August 2026 with the project's current maintenance status and what to use instead if you need Flux or newer models.

Fooocus in 2026: Still Works, Barely Maintained {#status}

Short answer: Fooocus still runs fine in 2026 and remains the easiest way to generate SDXL images. But the original project is in bug-fix-only maintenance, it will never support Flux or newer models, and fresh installs need a couple of workarounds on current hardware. Here is the honest status picture, checked against the repos in August 2026:

• Frozen, not dead. The original lllyasviel/Fooocus repo is not archived, but its README declares "a state of limited long-term support (LTS) with bug fixes only" and no plans to adopt newer model architectures. The last major release was v2.5.0, and the repo still saw maintenance activity in early 2026.
• Install the maintained fork. mashb1t's "1-Up Edition" (github.com/mashb1t/Fooocus, currently v2.6.0) is the practical continuation: same UI, same SDXL-only scope, plus 90+ merged pull requests of fixes and quality-of-life features. Details in the fork section.
• Fresh-install caveats. Stick to Python 3.10; newer Python versions fight the pinned dependencies. On RTX 50-series (Blackwell) cards the pinned PyTorch has no sm_120 kernels and fails with "no kernel image is available for execution". Fix: upgrade PyTorch inside the Fooocus environment to a CUDA 12.8 build (torch 2.7+): pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128
• What replaced it. If you need Flux, SD 3.5, or active development, pick a successor: SD Forge (same developer, native Flux support, similar low-VRAM friendliness), ComfyUI with a simple drop-in workflow such as our Flux workflow guide, or InvokeAI, the closest match to Fooocus's beginner-first polish that is still actively developed.

If your work is SDXL — Pony, Illustrious, RealVis, product shots, wallpapers — none of this should scare you off. Fooocus remains the fastest route from prompt to good image, and everything below still applies.

Table of Contents

1. What Fooocus Is
2. Fooocus vs A1111 / Forge / ComfyUI
3. Hardware Requirements
4. Installation: Windows, Linux, Mac
5. The Simplified UI Tour
6. Performance Presets (Speed, Quality, Extreme Speed)
7. Aspect Ratio Picker
8. Style System
9. Prompt Expansion
10. Image Prompt and Image-to-Image
11. Inpainting
12. Using Custom Checkpoints (Pony, Illustrious)
13. Adding LoRAs
14. Advanced Settings
15. The mashb1t Fork ("1-Up Edition")
16. API Mode
17. Tuning by GPU
18. When Fooocus Is Not the Right Tool
19. Troubleshooting
20. FAQ

---

What Fooocus Is {#what-it-is}

Fooocus (lllyasviel/Fooocus) is a Python application built on top of the same backend that powers SD Forge — the dynamic UNet patcher, ControlNet integration, and SDXL pipeline. The difference is the user interface: where A1111 and Forge expose every knob, Fooocus exposes ~5 high-level controls and bakes good defaults into everything else.

The design thesis: most users want beautiful images, not parameter exploration. Default to "good enough that you don't need to tune" and provide escape hatches under an Advanced panel for the rest.

Project: github.com/lllyasviel/Fooocus. Maintenance status: limited long-term support since 2024, bug fixes only; mashb1t's 1-Up Edition fork carries development forward in 2026 — see the status section.

---

Fooocus vs A1111 / Forge / ComfyUI {#comparison}

For photographers/artists who want to make beautiful pictures rather than learn diffusion theory, Fooocus is the rational choice.

---

Hardware Requirements {#requirements}

System RAM 16 GB minimum. Disk 30 GB for SDXL base + a few LoRAs + outputs. Apple Silicon supported via MPS.

---

Installation: Windows, Linux, Mac {#installation}

Windows (one-click)

# Download and unzip Fooocus_win64.zip from the releases page
# Run run.bat

The zip includes Python and dependencies. Total size ~5 GB unzipped.

Linux

git clone https://github.com/lllyasviel/Fooocus
cd Fooocus
python3.10 -m venv venv && source venv/bin/activate
pip install -r requirements_versions.txt
python launch.py

For the maintained mashb1t fork (recommended in 2026): replace the clone URL with https://github.com/mashb1t/Fooocus. On RTX 50-series cards, upgrade PyTorch to a CUDA 12.8 build afterward — see the status section.

Mac (Apple Silicon)

git clone https://github.com/lllyasviel/Fooocus
cd Fooocus
./run_anime.sh   # or run_realistic.sh — Mac-friendly entry points

MPS is auto-detected. Performance lags NVIDIA — Draw Things (MLX-native) is faster on Mac for image gen.

---

The Simplified UI Tour {#ui-tour}

After launch, browse to http://localhost:7865. The UI:

• Top bar: prompt input + Generate button
• Left: previous outputs gallery
• Right (optional): Advanced panel toggle
• Bottom dropdowns: Performance, Aspect Ratio, Style, Image Number

Type a prompt, click Generate. That is the entire required workflow.

---

Performance Presets (Speed, Quality, Extreme Speed) {#performance-presets}

Speed is the right default. Switch to Quality for final renders, Extreme Speed for brainstorming dozens of variations.

---

Aspect Ratio Picker {#aspect-ratio}

Fooocus exposes ~12 SDXL-trained aspect ratios:

• 1024 × 1024 (square, default)
• 1152 × 896, 896 × 1152
• 1216 × 832, 832 × 1216
• 1344 × 768, 768 × 1344
• 1536 × 640, 640 × 1536
• • a few more

These match the resolutions SDXL was trained on. Off-spec ratios produce worse images. The UI nudges you toward the trained ratios; do not fight this.

---

Style System {#styles}

The Style dropdown contains 100+ pre-baked combinations: prompt prefixes/suffixes + recommended sampler/scheduler + style-appropriate negatives. Top picks:

• Fooocus V2 — default refined Fooocus look
• Fooocus Photograph — photorealistic
• Fooocus Cinematic — film-style
• Fooocus Anime — clean 2D
• MRE Manga — manga panel style
• MRE Bad Dream — surrealist
• SAI Anime / SAI Cinematic / SAI Fantasy Art — Stability's presets
• Photo Long Exposure / Photo Macro / Photo Polaroid — specific photo styles

Stack multiple styles by ticking checkboxes. Each style appends its prompt/parameters; combinations work well or weirdly depending on alignment.

---

Prompt Expansion {#prompt-expansion}

Fooocus uses a small GPT-2 model fine-tuned on Stable Diffusion prompts to automatically expand short user inputs.

Input: "a samurai" Expanded: "a samurai, cinematic photo, ultra-detailed, sharp focus, 35mm film, masterpiece, beautiful lighting, depth of field"

The expansion is non-deterministic and changes per generation, providing built-in variety. Disable in Advanced → Performance → Disable Prompt Expansion if you want raw control.

For users coming from "negative prompt soup" workflows, prompt expansion replaces ~80% of the value with zero effort.

---

Image Prompt and Image-to-Image {#image-prompt}

The Input Image panel (top right) accepts a reference image. Modes:

• Image Prompt — match the reference's style/composition (similar to IPAdapter)
• PyraCanny — sketch / line art conditioning
• CPDS — depth-aware composition matching
• FaceSwap — copy a face from reference
• Inpaint — mask and regenerate part of the reference

You can stack up to 4 image prompts simultaneously, each with its own weight (Stop At slider).

Under the hood: Fooocus dispatches to ControlNet / IPAdapter as appropriate. The UI hides the model picker and just offers the high-level capability.

---

Inpainting {#inpainting}

In Input Image → Inpaint:

1. Drop reference image
2. Paint mask with the brush tool
3. Pick mode:
   • Improve Detail — preserve content, enhance quality
   • Modify Content — replace with prompt
4. Optional: type prompt for the masked area
5. Generate

Fooocus auto-tunes denoising strength, sampler, and outpainting expansion based on the chosen mode. For deep inpainting workflows (multi-step refinement, dedicated inpaint checkpoints), use A1111 or ComfyUI.

---

Using Custom Checkpoints (Pony, Illustrious) {#custom-checkpoints}

Place SDXL .safetensors checkpoints in:

Fooocus/models/checkpoints/

For Pony Diffusion v6 XL, Illustrious XL, RealVisXL, etc. Fooocus auto-detects on next launch. Pick from the Base Model dropdown in Advanced panel.

For Pony / Illustrious specifically, you may need to disable some Fooocus prompt expansion (it adds tokens the anime models don't respond to well) — toggle in Advanced → Performance.

---

Adding LoRAs {#loras}

Place .safetensors LoRAs in:

Fooocus/models/loras/

Advanced panel → LoRAs section: pick up to 5 with individual weights (default 0.5). Stacking 3+ strong LoRAs typically over-conditions the output; stick to 1-2 with strength 0.6-1.0 unless you know what you're doing.

For trigger-word LoRAs (most Civitai LoRAs), include the trigger word in your prompt — Fooocus does not auto-inject.

---

Advanced Settings {#advanced}

The Advanced panel exposes everything Fooocus normally hides:

• Base Model and 5 LoRA slots
• Refiner Model + Refiner Switch (Base/Refiner crossover step)
• Sampler / Scheduler (overrides preset)
• Sharpness / Guidance Scale (CFG)
• ADM Guidance (positive/negative scales)
• Sampler-specific parameters
• Prompt expansion enable/disable
• Custom negative prompt

Most users should never touch this. When you do, you typically have a specific reason — chasing a particular aesthetic that the defaults don't hit.

---

The mashb1t Fork ("1-Up Edition") {#mre}

mashb1t's fork (https://github.com/mashb1t/Fooocus) is the actively developed branch in 2026, currently at v2.6.0 with 90+ merged pull requests over the original. Adds:

• Hyper-SD presets (4-step)
• Lightning presets
• More style options
• Enhanced detailers (face / hand fix)
• Better metadata handling and mask generation
• API improvements

What it does not add: Flux or SD 3.5. No Fooocus branch runs anything newer than SDXL — for those models use SD Forge or ComfyUI.

Install the same way as original Fooocus. UI is essentially unchanged.

---

API Mode {#api}

Fooocus has a community API project: mrhan1993/Fooocus-API provides REST endpoints wrapping Fooocus generation:

git clone https://github.com/mrhan1993/Fooocus-API
cd Fooocus-API
pip install -r requirements.txt
python main.py

Endpoints: POST /v1/generation/text-to-image, POST /v1/generation/image-prompt, POST /v1/generation/inpaint-outpaint. OpenAPI docs at /docs.

For OpenAI-compatible image generation API (/v1/images/generations), use LocalAI which can wrap any SDXL backend.

---

Tuning by GPU {#tuning}

RTX 3060 12 GB

Default Fooocus works. Performance: ~12-15 sec/image at Speed preset. Use Extreme Speed for iteration.

RTX 4090 24 GB

Default Fooocus works flawlessly. Generate 4 images at once via Image Number = 4 — still ~5 sec per image (parallel batching).

RTX 5090 32 GB

Same as 4090 but ~2x faster.

Tight VRAM (4-6 GB)

python launch.py --always-low-vram

SDXL still works, ~25-40 sec/image. Use Extreme Speed preset for ~10 sec.

Apple M4 Max

Default works via MPS. Performance: ~22-28 sec at Speed. For better Mac speed, switch to Draw Things (MLX-native).

AMD RX 7900 XTX

Use the lshqqytiger AMD-friendly fork or set ROCm PyTorch first. Performance: ~7-9 sec at Speed.

---

When Fooocus Is Not the Right Tool {#not-right}

• Need Flux Dev / SD 3.5 with full feature support — use Forge or ComfyUI.
• Need fine-grained workflow control (multi-stage refinement, regional prompting, custom node graphs) — ComfyUI.
• Need specific A1111 extensions (Roop, advanced training, custom scripts) — A1111.
• Need video generation (Wan, HunyuanVideo) — ComfyUI.
• Need API-first deployment with full SDXL feature set — A1111 with --api or LocalAI.
• Want an actively maintained all-in-one app with a beginner-friendly UI — InvokeAI.
• Want to learn the diffusion stack — start with A1111 or ComfyUI; Fooocus hides too much.

For everyone else: Fooocus.

---

Troubleshooting {#troubleshooting}

---

FAQ {#faq}

See answers to common Fooocus questions below.

---

Sources: Fooocus GitHub (original) | mashb1t 1-Up Edition | Fooocus-API | Internal benchmarks RTX 3060, 4090, RX 7900 XTX, M4 Max. Status details re-checked against both repos in August 2026.

Related guides:

• Automatic1111 Guide
• SD Forge Guide
• ComfyUI Complete Guide
• InvokeAI Guide
• Local AI Photographers
• Local AI Content Creators
• Best GPUs for AI 2025