Skip to content

Commit dda14cf

Browse files
authored
Merge branch 'lllyasviel:main' into main
2 parents 4e96487 + d7439b2 commit dda14cf

File tree

1 file changed

+25
-31
lines changed

1 file changed

+25
-31
lines changed

Diff for: readme.md

+25-31
Original file line numberDiff line numberDiff line change
@@ -176,41 +176,31 @@ Speed A1111 scheme
176176

177177
<div align=center>
178178
<img src="https://github.com/lllyasviel/Fooocus/assets/19834515/483fb86d-c9a2-4c20-997c-46dafc124f25">
179-
180-
**Non-cherry-picked** random batch by just typing two words "forest elf",
181-
182-
without any parameter tweaking, without any strange prompt tags.
183-
184-
See also **non-cherry-picked** generalization and diversity tests [here](https://github.com/lllyasviel/Fooocus/discussions/2067) and [here](https://github.com/lllyasviel/Fooocus/discussions/808) and [here](https://github.com/lllyasviel/Fooocus/discussions/679) and [here](https://github.com/lllyasviel/Fooocus/discussions/679#realistic).
185-
186-
In the entire open source community, only Fooocus can achieve this level of **non-cherry-picked** quality.
187-
188179
</div>
189180

190-
191181
# Fooocus
192182

193-
Fooocus is an image generating software (based on [Gradio](https://www.gradio.app/)).
183+
[>>> Click Here to Install Fooocus <<<](#download)
194184

195-
Fooocus is a rethinking of Stable Diffusion and Midjourney’s designs:
185+
Fooocus is an image generating software (based on [Gradio](https://www.gradio.app/) <a href='https://github.com/gradio-app/gradio'><img src='https://img.shields.io/github/stars/gradio-app/gradio'></a>).
196186

197-
* Learned from Stable Diffusion, the software is offline, open source, and free.
187+
Fooocus presents a rethinking of image generator designs. The software is offline, open source, and free, while at the same time, similar to many online image generators like Midjourney, the manual tweaking is not needed, and users only need to focus on the prompts and images. Fooocus has also simplified the installation: between pressing "download" and generating the first image, the number of needed mouse clicks is strictly limited to less than 3. Minimal GPU memory requirement is 4GB (Nvidia).
198188

199-
* Learned from Midjourney, the manual tweaking is not needed, and users only need to focus on the prompts and images.
189+
**Recently many fake websites exist on Google when you search “fooocus”. Do not trust those – here is the only official source of Fooocus.**
200190

201-
Fooocus has included and automated [lots of inner optimizations and quality improvements](#tech_list). Users can forget all those difficult technical parameters, and just enjoy the interaction between human and computer to "explore new mediums of thought and expanding the imaginative powers of the human species" `[1]`.
191+
# Project Status: Limited Long-Term Support (LTS) with Bug Fixes Only
202192

203-
Fooocus has simplified the installation. Between pressing "download" and generating the first image, the number of needed mouse clicks is strictly limited to less than 3. Minimal GPU memory requirement is 4GB (Nvidia).
193+
The Fooocus project, built entirely on the **Stable Diffusion XL** architecture, is now in a state of limited long-term support (LTS) with bug fixes only. As the existing functionalities are considered as nearly free of programmartic issues (Thanks to [mashb1t](https://github.com/mashb1t)'s huge efforts), future updates will focus exclusively on addressing any bugs that may arise.
204194

205-
`[1]` David Holz, 2019.
195+
**There are no current plans to migrate to or incorporate newer model architectures.** However, this may change during time with the development of open-source community. For example, if the community converge to one single dominant method for image generation (which may really happen in half or one years given the current status), Fooocus may also migrate to that exact method.
206196

207-
**Recently many fake websites exist on Google when you search “fooocus”. Do not trust those – here is the only official source of Fooocus.**
197+
For those interested in utilizing newer models such as **Flux**, we recommend exploring alternative platforms such as [WebUI Forge](https://github.com/lllyasviel/stable-diffusion-webui-forge) (also from us), [ComfyUI/SwarmUI](https://github.com/comfyanonymous/ComfyUI). Additionally, several [excellent forks of Fooocus](https://github.com/lllyasviel/Fooocus?tab=readme-ov-file#forks) are available for experimentation.
208198

209-
## [Installing Fooocus](#download)
199+
Again, recently many fake websites exist on Google when you search “fooocus”. Do **NOT** get Fooocus from those websites – this page is the only official source of Fooocus. We never have any website like such as “fooocus.com”, “fooocus.net”, “fooocus.co”, “fooocus.ai”, “fooocus.org”, “fooocus.pro”, “fooocus.one”. Those websites are ALL FAKE. **They have ABSOLUTLY no relationship to us. Fooocus is a 100% non-commercial offline open-source software.**
210200

211-
# Moving from Midjourney to Fooocus
201+
# Features
212202

213-
Using Fooocus is as easy as (probably easier than) Midjourney – but this does not mean we lack functionality. Below are the details.
203+
Below is a quick list using Midjourney's examples:
214204

215205
| Midjourney | Fooocus |
216206
| - | - |
@@ -231,15 +221,15 @@ Using Fooocus is as easy as (probably easier than) Midjourney – but this does
231221
| InsightFace | Input Image -> Image Prompt -> Advanced -> FaceSwap |
232222
| Describe | Input Image -> Describe |
233223

234-
We also have a few things borrowed from the best parts of LeonardoAI:
224+
Below is a quick list using LeonardoAI's examples:
235225

236226
| LeonardoAI | Fooocus |
237227
| - | - |
238228
| Prompt Magic | Advanced -> Style -> Fooocus V2 |
239229
| Advanced Sampler Parameters (like Contrast/Sharpness/etc) | Advanced -> Advanced -> Sampling Sharpness / etc |
240230
| User-friendly ControlNets | Input Image -> Image Prompt -> Advanced |
241231

242-
Fooocus also developed many "fooocus-only" features for advanced users to get perfect results. [Click here to browse the advanced features.](https://github.com/lllyasviel/Fooocus/discussions/117)
232+
Also, [click here to browse the advanced features.](https://github.com/lllyasviel/Fooocus/discussions/117)
243233

244234
# Download
245235

@@ -505,7 +495,8 @@ In both ways the access is unauthenticated by default. You can add basic authent
505495
## List of "Hidden" Tricks
506496
<a name="tech_list"></a>
507497
508-
The below things are already inside the software, and **users do not need to do anything about these**.
498+
<details>
499+
<summary>Click to see a list of tricks. Those are based on SDXL and are not very up-to-date with latest models.</summary>
509500
510501
1. GPT2-based [prompt expansion as a dynamic style "Fooocus V2".](https://github.com/lllyasviel/Fooocus/discussions/117#raw) (similar to Midjourney's hidden pre-processing and "raw" mode, or the LeonardoAI's Prompt Magic).
511502
2. Native refiner swap inside one single k-sampler. The advantage is that the refiner model can now reuse the base model's momentum (or ODE's history parameters) collected from k-sampling to achieve more coherent sampling. In Automatic1111's high-res fix and ComfyUI's node system, the base model and refiner use two independent k-samplers, which means the momentum is largely wasted, and the sampling continuity is broken. Fooocus uses its own advanced k-diffusion sampling that ensures seamless, native, and continuous swap in a refiner setup. (Update Aug 13: Actually, I discussed this with Automatic1111 several days ago, and it seems that the “native refiner swap inside one single k-sampler” is [merged]( https://github.com/AUTOMATIC1111/stable-diffusion-webui/pull/12371) into the dev branch of webui. Great!)
@@ -521,6 +512,7 @@ The below things are already inside the software, and **users do not need to do
521512
12. Using automatic1111's method to normalize prompt emphasizing. This significantly improves results when users directly copy prompts from civitai.
522513
13. The joint swap system of the refiner now also supports img2img and upscale in a seamless way.
523514
14. CFG Scale and TSNR correction (tuned for SDXL) when CFG is bigger than 10.
515+
</details>
524516
525517
## Customization
526518
@@ -607,6 +599,7 @@ entry_with_update.py [-h] [--listen [IP]] [--port PORT]
607599
## Inline Prompt Features
608600

609601
### Wildcards
602+
610603
Example prompt: `__color__ flower`
611604

612605
Processed for positive and negative prompt.
@@ -618,6 +611,7 @@ You can also disable randomness and process a wildcard file from top to bottom b
618611
Wildcards can be nested and combined, and multiple wildcards can be used in the same prompt (example see `wildcards/color_flower.txt`).
619612

620613
### Array Processing
614+
621615
Example prompt: `[[red, green, blue]] flower`
622616

623617
Processed only for positive prompt.
@@ -636,32 +630,32 @@ Processed only for positive prompt.
636630

637631
Applies a LoRA to the prompt. The LoRA file must be located in the `models/loras` directory.
638632

639-
640633
## Advanced Features
641634

642635
[Click here to browse the advanced features.](https://github.com/lllyasviel/Fooocus/discussions/117)
643636

644637
## Forks
645-
Fooocus also has many community forks, just like SD-WebUI's [vladmandic/automatic](https://github.com/vladmandic/automatic) and [anapnoe/stable-diffusion-webui-ux](https://github.com/anapnoe/stable-diffusion-webui-ux), for enthusiastic users who want to try!
638+
639+
Below are some Forks to Fooocus:
646640

647641
| Fooocus' forks |
648642
| - |
649643
| [fenneishi/Fooocus-Control](https://github.com/fenneishi/Fooocus-Control) </br>[runew0lf/RuinedFooocus](https://github.com/runew0lf/RuinedFooocus) </br> [MoonRide303/Fooocus-MRE](https://github.com/MoonRide303/Fooocus-MRE) </br> [metercai/SimpleSDXL](https://github.com/metercai/SimpleSDXL) </br> [mashb1t/Fooocus](https://github.com/mashb1t/Fooocus) </br> and so on ... |
650644

651-
See also [About Forking and Promotion of Forks](https://github.com/lllyasviel/Fooocus/discussions/699).
652-
653645
## Thanks
654646

655-
Special thanks to [twri](https://github.com/twri) and [3Diva](https://github.com/3Diva) and [Marc K3nt3L](https://github.com/K3nt3L) for creating additional SDXL styles available in Fooocus. Thanks [daswer123](https://github.com/daswer123) for contributing the Canvas Zoom!
647+
Many thanks to [twri](https://github.com/twri) and [3Diva](https://github.com/3Diva) and [Marc K3nt3L](https://github.com/K3nt3L) for creating additional SDXL styles available in Fooocus.
648+
649+
The project starts from a mixture of [Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui) and [ComfyUI](https://github.com/comfyanonymous/ComfyUI) codebases.
650+
651+
Also, thanks [daswer123](https://github.com/daswer123) for contributing the Canvas Zoom!
656652

657653
## Update Log
658654

659655
The log is [here](update_log.md).
660656

661657
## Localization/Translation/I18N
662658

663-
**We need your help!** Please help translate Fooocus into international languages.
664-
665659
You can put json files in the `language` folder to translate the user interface.
666660

667661
For example, below is the content of `Fooocus/language/example.json`:

0 commit comments

Comments
 (0)