update_log.md

**(2023 Nov 26) Hi all, the feature updating of Fooocus will be paused for about two or three weeks because we have some other workloads. See you soon and we will come back in mid December. However, you may still see updates if other collaborators are fixing bugs or solving problems.**

# 2.1.823

* Fix some potential problem when LoRAs has clip keys and user want to load those LoRAs to refiners.

# 2.1.822

* New inpaint system (inpaint beta test ends).

# 2.1.821

* New UI for LoRAs.
* Improved preset system: normalized preset keys and file names.
* Improved session system: now multiple users can use one Fooocus at the same time without seeing others' results.
* Improved some computation related to model precision.
* Improved config loading system with user-friendly prints.

# 2.1.820

* support "--disable-image-log" to prevent writing images and logs to hard drive.

# 2.1.819

* Allow disabling preview in dev tools.

# 2.1.818

* Fix preset lora failed to load when the weight is exactly one.

# 2.1.817

* support "--theme dark" and "--theme light".
* added preset files "default" and "lcm", these presets exist but will not create launcher files (will not be exposed to users) to keep entry clean. The "--preset lcm" is equivalent to select "Extreme Speed" in UI, but will likely to make some online service deploying easier.

# 2.1.815

* Multiple loras in preset.

# 2.1.814

* Allow using previous preset of official SAI SDXL by modify the args to '--preset sai'. ~Note that this preset will set inpaint engine back to previous v1 to get same results like before. To change the inpaint engine to v2.6, use the dev tools -> inpaint engine -> v2.6.~ (update: it is not needed now after some tests.)

# 2.1.813

* Allow preset to set default inpaint engine.

# 2.1.812

* Allow preset to set default performance.
* heunpp2 sampler.

# 2.1.810

* Added hints to config_modification_tutorial.txt
* Removed user hacked aspect ratios in I18N english templates, but it will still be read like before.
* fix some style sorting problem again (perhaps should try Gradio 4.0 later).
* Refreshed I18N english templates with more keys.

# 2.1.809

* fix some sorting problem.

# 2.1.808

* Aspect ratios now show aspect ratios.
* Added style search.
* Added style sorting/ordering/favorites.

# 2.1.807

* Click on image to see it in full screen.

# 2.1.806

* Fix some lora problems related to clip.

# 2.1.805

* Responsive UI for small screens.
* Added skip preprocessor in dev tools.

# 2.1.802

* Default inpaint engine changed to v2.6. You can still use inpaint engine v1 in dev tools.
* Fix some VRAM problems.

# 2.1.799

* Added 'Extreme Speed' performance mode (based on LCM). The previous complicated settings are not needed now.

# 2.1.798

* added lcm scheduler - LCM may need to set both sampler and scheduler to "lcm". Other than that, see the description in 2.1.782 logs.

# 2.1.797

* fixed some dependency problems with facexlib and filterpy.

# 2.1.793

* Added many javascripts to improve user experience. Now users with small screen will always see full canvas without needing to scroll.

# 2.1.790

* Face swap (in line with Midjourney InsightFace): Input Image -> Image Prompt -> Advanced -> FaceSwap
* The performance is super high. Use it carefully and never use it in any illegal things!
* This implementation will crop faces for you and you do NOT need to crop faces before feeding images into Fooocus. (If you previously manually crop faces from images for other software, you do not need to do that now in Fooocus.)

# 2.1.788

* Fixed some math problems in previous versions.
* Inpaint engine v2.6 join the beta test of Fooocus inpaint models. Use it in dev tools -> inpaint engine -> v2.6 .

# 2.1.785

* The `user_path_config.txt` is deprecated since 2.1.785. If you are using it right now, please use the new `config.txt` instead. See also the new documentation in the Readme.
* The paths in `user_path_config.txt` will still be loaded in recent versions, but it will be removed soon.
* We use very user-friendly method to automatically transfer your path settings from `user_path_config.txt` to `config.txt` and usually you do not need to do anything.
* The new `config.txt` will never save default values so the default value changes in scripts will not be prevented by old config files.

# 2.1.782

2.1.782 is mainly an update for a new LoRA system that supports both SDXL loras and SD1.5 loras.

Now when you load a lora, the following things will happen:

1. try to load the lora to the base model, if failed (model mismatch), then try to load the lora to refiner.
2. try to load the lora to refiner, if failed (model mismatch) then do nothing.

In this way, Fooocus 2.1.782 can benefit from all models and loras from CivitAI with both SDXL and SD1.5 ecosystem, using the unique Fooocus swap algorithm, to achieve extremely high quality results (although the default setting is already very high quality), especially in some anime use cases, if users really want to play with all these things.

Recently the community also developed LCM loras. Users can use it by setting the sampler as 'LCM', scheduler as 'sgm_uniform' (Update in 2.1.798: scheduler should also be "lcm"), the forced overwrite of sampling step as 4 to 8, and CFG guidance as 1.0, in dev tools. Do not forget to change the LCM lora weight to 1.0 (many people forget this and report failure cases). Also, set refiner to None. If LCM's feedback in the artists community is good (not the feedback in the programmer community of Stable Diffusion), Fooocus may add some other shortcuts in the future.

# 2.1.781

(2023 Oct 26) Hi all, the feature updating of Fooocus will (really, really, this time) be paused for about two or three weeks because we really have some other workloads. Thanks for the passion of you all (and we in fact have kept updating even after last pausing announcement a week ago, because of many great feedbacks)  - see you soon and we will come back in mid November. However, you may still see updates if other collaborators are fixing bugs or solving problems.

* Disable refiner to speed up when new users mistakenly set same model to base and refiner.

# 2.1.779

* Disable image grid by default because many users reports performance issues. For example, https://github.com/lllyasviel/Fooocus/issues/829 and so on. The image grid will cause problem when user hard drive is not super fast, or when user internet connection is not very good (eg, run in remote). The option is moved to dev tools if users want to use it. We will take a look at it later.

# 2.1.776

* Support Ctrl+Up/Down Arrow to change prompt emphasizing weights.

# 2.1.750

* New UI: now you can get each image during generating.

# 2.1.743

* Improved GPT2 by removing some tokens that may corrupt styles.

# 2.1.741

Style Updates:

* "Default (Slightly Cinematic)" as renamed to "Fooocus Cinematic".
* "Default (Slightly Cinematic)" is canceled from default style selections. 
* Added "Fooocus Sharp". This style combines many CivitAI prompts that reduces SDXL blurry and improves sharpness in a relatively natural way.
* Added "Fooocus Enhance". This style mainly use the very popular [default negative prompts from JuggernautXL](https://civitai.com/models/133005) and some other enhancing words. JuggernautXL's negative prompt has been proved to be very effective in many recent image posts on CivitAI to improve JuggernautXL and many other models.
* "Fooocus Sharp" and "Fooocus Enhance" and "Fooocus V2" becomes the new default set of styles.
* Removed the default text in the "negative prompt" input area since it is not necessary now.
* You can reproduce previous results by using "Fooocus Cinematic".
* "Fooocus Sharp" and "Fooocus Enhance" may undergo minor revision in future updates.

# 2.1.739

* Added support for authentication in --share mode (via auth.json).

# 2.1.737

* Allowed customizing resolutions in config. 

Modifying this will make results worse if you do not understand how Positional Encoding works. 

You have been warned.

If you do not know why numbers must be transformed with many Sin and Cos functions (yes, those Trigonometric functions that you learn in junior high school) before they are fed to SDXL, we do not encourage you to change this - you will become a victim of Positional Encoding. You are likely to suffer from an easy-to-fail tool, rather than getting more control.

Your knowledge gained from SD1.5 (for example, resolution numbers divided by 8 or 64 are good enough for UNet) does not work in SDXL. The SDXL uses Positional Encoding. The SD1.5 does not use Positional Encoding. They are completely different. 

Your knowledge gained from other resources (for example, resolutions around 1024 are good enough for SDXL) is wrong. The SDXL uses Positional Encoding. People who say "all resolutions around 1024 are good" do not understand what is Positional Encoding. They are not intentionally misleading. They are just not aware of the fact that SDXL is using Positional Encoding. 

The number 1152 must be exactly 1152, not 1152-1, not 1152+1, not 1152-8, not 1152+8. The number 1152 must be exactly 1152. Just Google what is a Positional Encoding.

Again, if you do not understand how Positional Encoding works, just do not change the resolution numbers.

# 2.1.735

* Fixed many problems related to torch autocast.

# 2.1.733

* Increased allowed random seed range.

# 2.1.728

* Fixed some potential numerical problems since 2.1.723

# 2.1.723

* Improve Fooocus Anime a bit by using better SD1.5 refining formulation.

# 2.1.722

* Now it is possible to translate 100% all texts in the UI.

# 2.1.721

* Added language/en.json to make translation easier.

# 2.1.720

* Added Canvas Zoom to inpaint canvas
* Fixed the problem that image will be cropped in UI when the uploaded image is too wide.

# 2.1.719

* I18N

# 2.1.718

* Corrected handling dash in wildcard names, more wildcards (extended-color).

# 2.1.717

* Corrected displaying multi-line prompts in Private Log.

# 2.1.716

* Added support for nested wildcards, more wildcards (flower, color_flower).

# 2.1.714

* Fixed resolution problems.

# 2.1.712

* Cleaned up Private Log (most users won't need information about raw prompts).

# 2.1.711

* Added more information about prompts in Private Log.
* Made wildcards in negative prompt use different seed.

# 2.1.710

* Added information about wildcards usage in console log.

# 2.1.709

* Allowed changing default values of advanced checkbox and image number.

# 2.1.707

* Updated Gradio to v3.41.2.

# 2.1.703

* Fixed many previous problems related to inpaint.

# 2.1.702

* Corrected reading empty negative prompt from config (it shouldn't turn into None).

# 2.1.701

* Updated FreeU node to v2 (gives less overcooked results).

# 2.1.699

* Disabled smart memory management (solves some memory issues).

# 2.1.698

* Added support for loading model files from subfolders.

# 2.1.696

* Improved wildcards implementation (using same wildcard multiple times will now return different values).

**(2023 Oct 18) Again, the feature updating of Fooocus will be paused for about two or three weeks because we have some other workloads - we will come back in early or mid November. However, you may still see updates if other collaborators are fixing bugs or solving problems.**

# 2.1.695 (requested emergency bug fix)

* Reduced 3.4GB RAM use when swapping base model.
* Reduced 372MB VRAM use in VAE decoding after using control model in image prompt.
* Note that Official ComfyUI (d44a2de) will run out of VRAM when using sdxl and control-lora on 2060 6GB that does not support float16 at resolution 1024. Fooocus 2.1.695 succeeded in outputting images without OOM using exactly same devices.

(2023 Oct 17) Announcement of update being paused.

# 2.1.693

* Putting custom styles before pre-defined styles.
* Avoided the consusion between Fooocus Anime preset and Fooocus Anime style (Fooocus Anime style is renamed to Fooocus Masterpiece because it does not make images Anime-looking if not using with Fooocus Anime preset).
* Fixed some minor bugs in Fooocus Anime preset's prompt emphasizing of commas.
* Supported and documented embedding grammar (and wildcards grammar). 
* This release is a relative stable version and many features are determined now.

# 2.1.687

* Added support for wildcards (using files from wildcards folder - try prompts like `__color__ sports car` with different seeds).

# 2.1.682

* Added support for custom styles (loaded from JSON files placed in sdxl_styles folder).

# 2.1.681

* Added support for generate hotkey (CTRL+ENTER).
* Added support for generate forever (RMB on Generate button).
* Added support for playing sound when generation is finished ('notification.ogg' or 'notification.mp3').

# 2.1.62

* Preset system. Added anime and realistic support.

# 2.1.52

* removed pygit2 dependency (expect auto update) so that people will never have permission denied problems.

# 2.1.50

* Begin to support sd1.5 as refiner. This method scale sigmas given SD15/Xl latent scale and is probably the most correct way to do it. I am going to write a discussion soon.

# 2.1.25

AMD support on Linux and Windows.

# 2.1.0

* Image Prompt
* Finished the "Moving from Midjourney" Table

# 2.0.85

* Speed Up Again

# 2.0.80

* Improved the scheduling of ADM guidance and CFG mimicking for better visual quality in high frequency domain and small objects.

# 2.0.80

* Rework many patches and some UI details.
* Speed up processing.
* Move Colab to independent branch.
* Implemented CFG Scale and TSNR correction when CFG is bigger than 10.
* Implemented Developer Mode with more options to debug.

### 2.0.72

(2023 sep 21) The feature updating of Fooocus will be paused for about two or three weeks because we have some events and travelling - we will come back in early or mid October. 

### 2.0.72

* Allow users to choose path of models.

### 2.0.65

* Inpaint model released.

### 2.0.50

* Variation/Upscale (Midjourney Toolbar) implemented.

### 2.0.16

* Virtual memory system implemented. Now Colab can run both base model and refiner model with 7.8GB RAM + 5.3GB VRAM, and it never crashes.
* If you are lucky enough to read this line, keep in mind that ComfyUI cannot do this. This is very reasonable that Fooocus is more optimized because it only need to handle a fixed pipeline, but ComfyUI need to consider arbitrary pipelines. 
* But if we just consider the optimization of this fixed workload, after 2.0.16, Fooocus has become the most optimized SDXL app, outperforming ComfyUI.

### 2.0.0

* V2 released.
* completely rewrite text processing pipeline (higher image quality and prompt understanding).
* support multi-style.
* In 100 tests (prompts written by ChatGPT), V2 default results outperform V1 default results in 87 cases, evaluated by two human.
* In 100 tests (prompts written by ChatGPT), V2 prompt understanding outperform V1 prompt understanding in 81 cases, evaluated by two human, in both default setting and multi/single style mode.
* Because the above number is above 80%, we view this as a major update and directly jump to 2.0.0.
* Some other things are renamed.

### 1.0.67

* Use dynamic weighting and lower weights for prompt expansion.

### 1.0.64

* Fixed a small OOM problem.

### 1.0.62

* Change prompt expansion to suffix mode for better balance of semantic and style (and debugging).

### 1.0.60

* Tune the balance between style and Prompt Expansion.

### 1.0.56

* Begin to use magic split.

### 1.0.55

* Minor changes of Prompt Expansion.

### 1.0.52

* Reduce the semantic corruption of Prompt Expansion.

### 1.0.51

* Speed up Prompt Expansion a bit.

### 1.0.50

* Prompt expansion and a "Raw mode" to turn it off (similar to Midjourney's "raw").

### 1.0.45

* Reworked SAG, removed unnecessary patch
* Reworked anisotropic filters for faster compute.
* Replaced with guided anisotropic filter for less distortion.

### 1.0.41

(The update of Fooocus will be paused for a period of time for AUTOMATIC1111 sd-webui 1.6.X, and some features will also be implemented as webui extensions)

### 1.0.40

* Behaviors reverted to 1.0.36 again (refiner steps). The 1.0.36 is too perfect and too typical; beating 1.0.36 is just impossible.

### 1.0.39

* Reverted unstable changes between 1.0.37 and 1.0.38 .
* Increased refiner steps to half of sampling steps.

### 1.0.36

* Change gaussian kernel to anisotropic kernel.

### 1.0.34

* Random seed restoring.

### 1.0.33

* Hide items in log when images are removed.

### 1.0.32

* Fooocus private log

### 1.0.31

* Fix typo and UI.

### 1.0.29

* Added "Advanced->Advanced->Advanced" block for future development.

### 1.0.29

* Fix overcook problem in 1.0.28

### 1.0.28

* SAG implemented

### 1.0.27

* Fix small problem in textbox css 

### 1.0.25

* support sys.argv --listen --share --port

### 1.0.24

* Taller input textbox.

### 1.0.23

* Added some hints on linux after UI start so users know the App does not fail.

### 1.0.20

* Support linux.

### 1.0.20

* Speed-up text encoder.

### 1.0.20

* Re-write UI to use async codes: (1) for faster start, and (2) for better live preview.
* Removed opencv dependency
* Plan to support Linux soon

### 1.0.19

* Unlock to allow changing model.

### 1.0.17

* Change default model to SDXL-1.0-vae-0.9. (This means the models will be downloaded again, but we should do it as early as possible so that all new users only need to download once. Really sorry for day-0 users. But frankly this is not too late considering that the project is just publicly available in less than 24 hours - if it has been a week then we will prefer more lightweight tricks to update.)

### 1.0.16

* Implemented "Fooocus/outputs" folder for saving user results.
* Ignored cv2 errors when preview fails.
* Mentioned future AMD support in Readme.
* Created this log.

### 1.0.15

Publicly available.

### 1.0.0

Initial Version.