lllyasviel/Fooocus

Focus on prompting and generating

50,927
GitHub 스타
8,324
포크
Python
언어
GPL-3.0
라이선스
2025.12.01
최근 푸시
2026.04.30
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
Fooocus는 Midjourney와 유사한 간편한 이미지 생성 경험을 원하지만 비용 부담 없이 오프라인에서 사용하려는 사용자에게 적합합니다. 특히 SDXL 기반의 고품질 이미지 생성과 다양한 편집 기능이 필요하고, 최신 모델 아키텍처에 대한 요구가 없는 경우에 추천합니다.

강점

  • Midjourney와 유사한 사용자 경험을 제공하면서도 오프라인에서 무료로 사용 가능
  • 설치가 매우 간편하여 다운로드 후 3번의 클릭만으로 첫 이미지 생성 가능
  • 4GB VRAM만으로도 구동 가능하여 저사양 GPU 사용자도 접근 가능
  • 자체 개발한 프롬프트 처리 엔진과 샘플링 개선으로 짧은 프롬프트에서도 고품질 결과 생성
  • Inpaint, Outpaint, Image Prompt 등 다양한 고급 기능을 내장

약점

  • Stable Diffusion XL 아키텍처에 고정되어 있어 Flux 등 최신 모델로의 마이그레이션 계획이 없음
  • 프로젝트가 제한된 장기 지원(LTS) 상태로, 버그 수정 외에 새로운 기능 업데이트는 없음
  • 최소 요구 사항을 충족하더라도 저사양 환경에서는 성능이 충분하지 않을 수 있음

주의사항

  • Google 검색 시 가짜 Fooocus 웹사이트가 많으므로 공식 GitHub 저장소에서만 다운로드해야 함
  • Nvidia 드라이버 버전에 따라 성능 차이가 크게 발생할 수 있으므로 적절한 드라이버 선택 필요
  • 모델 파일이 손상된 경우 'MetadataIncompleteBuffer' 오류가 발생할 수 있으므로 재다운로드 필요
  • Colab 무료 티어에서는 리소스 제한으로 인해 일부 고급 기능이 작동하지 않을 수 있음

시작 가이드

  • Windows 사용자는 공식 릴리스 페이지에서 압축 파일을 다운로드하여 압축 해제 후 run.bat 실행
  • Linux 사용자는 Anaconda 또는 Python venv를 이용해 저장소를 클론하고 환경 설정 후 entry_with_update.py 실행
  • Colab 사용자는 공식 Colab 노트북을 열고 필요에 따라 프리셋 인자를 추가하여 실행
  • 처음 실행 시 자동으로 모델이 다운로드되므로 인터넷 연결과 충분한 디스크 공간 확보
  • 저사양 환경에서는 Nvidia 드라이버 531 버전 사용 및 가상 메모리 설정 확인

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Fooocus

>>> Fooocus 설치하려면 여기를 클릭하세요 <<<

Fooocus는 (Gradio 기반의) 이미지 생성 소프트웨어입니다.

Fooocus는 이미지 생성기 설계에 대한 재고를 제시합니다. 이 소프트웨어는 오프라인, 오픈 소스, 무료이며, 동시에 Midjourney와 같은 많은 온라인 이미지 생성기와 유사하게 수동 조정이 필요 없고 사용자는 프롬프트와 이미지에만 집중하면 됩니다. Fooocus는 또한 설치를 단순화했습니다: "다운로드"를 누르고 첫 번째 이미지를 생성하기까지 필요한 마우스 클릭 수는 엄격히 3회 미만으로 제한됩니다. 최소 GPU 메모리 요구 사항은 4GB(Nvidia)입니다.

최근 Google에서 "fooocus"를 검색하면 많은 가짜 웹사이트가 존재합니다. 그것들을 신뢰하지 마십시오 – 여기가 Fooocus의 유일한 공식 소스입니다.

프로젝트 상태: 버그 수정만 있는 제한된 장기 지원(LTS)

Fooocus 프로젝트는 전적으로 Stable Diffusion XL 아키텍처를 기반으로 구축되었으며, 이제 버그 수정만 있는 제한된 장기 지원(LTS) 상태에 있습니다. 기존 기능은 프로그래밍 문제가 거의 없는 것으로 간주되므로( mashb1t의 큰 노력 덕분에), 향후 업데이트는 발생할 수 있는 모든 버그를 해결하는 데만 집중할 것입니다.

새로운 모델 아키텍처로 마이그레이션하거나 통합할 현재 계획은 없습니다. 그러나 이는 오픈 소스 커뮤니티의 발전에 따라 시간이 지남에 따라 변경될 수 있습니다. 예를 들어, 커뮤니티가 이미지 생성을 위한 하나의 지배적인 방법으로 수렴한다면(현재 상태에서 반년 또는 1년 안에 실제로 발생할 수 있음), Fooocus도 그 정확한 방법으로 마이그레이션할 수 있습니다.

Flux와 같은 최신 모델을 활용하는 데 관심이 있는 분들은 WebUI Forge (저희 제작), ComfyUI/SwarmUI와 같은 대체 플랫폼을 탐색해 보시기 바랍니다. 또한 실험을 위해 여러 훌륭한 Fooocus 포크를 사용할 수 있습니다.

다시 말씀드리지만, 최근 Google에서 "fooocus"를 검색하면 많은 가짜 웹사이트가 존재합니다. 그러한 웹사이트에서 Fooocus를 절대 받지 마십시오 – 이 페이지가 Fooocus의 유일한 공식 소스입니다. "fooocus.com", "fooocus.net", "fooocus.co", "fooocus.ai", "fooocus.org", "fooocus.pro", "fooocus.one"과 같은 웹사이트는 전혀 없습니다. 그 웹사이트들은 모두 가짜입니다. 그들은 우리와 전혀 관계가 없습니다. Fooocus는 100% 비상업적 오프라인 오픈 소스 소프트웨어입니다.

기능

다음은 Midjourney의 예제를 사용한 빠른 목록입니다:

Midjourney Fooocus

| - | - |

많은 프롬프트 엔지니어링이나 매개변수 조정 없이 고품질 텍스트-이미지 생성. <br> (알 수 없는 방법) 많은 프롬프트 엔지니어링이나 매개변수 조정 없이 고품질 텍스트-이미지 생성. <br> (Fooocus는 오프라인 GPT-2 기반 프롬프트 처리 엔진과 많은 샘플링 개선 사항을 가지고 있어 프롬프트가 "house in garden"처럼 짧든 1000단어처럼 길든 항상 아름다운 결과를 제공합니다)

| V1 V2 V3 V4 | 입력 이미지 -> 업스케일 또는 변형 -> Vary (Subtle) / Vary (Strong) |

U1 U2 U3 U4 입력 이미지 -> 업스케일 또는 변형 -> Upscale (1.5x) / Upscale (2x)

| Inpaint / Up / Down / Left / Right (Pan) | 입력 이미지 -> Inpaint 또는 Outpaint -> Inpaint / Up / Down / Left / Right <br> (Fooocus는 자체 inpaint 알고리즘과 inpaint 모델을 사용하여 표준 SDXL inpaint 방법/모델을 사용하는 다른 모든 소프트웨어보다 결과가 더 만족스럽습니다) |

Image Prompt 입력 이미지 -> Image Prompt <br> (Fooocus는 자체 이미지 프롬프트 알고리즘을 사용하여 표준 IP-Adapter나 Revisions와 같은 표준 SDXL 방법을 사용하는 다른 모든 소프트웨어보다 결과 품질과 프롬프트 이해도가 더 만족스럽습니다)

| --style | 고급 -> 스타일 |

--stylize 고급 -> 고급 -> Guidance

| --niji | 여러 실행기: "run.bat", "runanime.bat", "runrealistic.bat". <br> Fooocus는 Civitai의 SDXL 모델을 지원합니다 <br> (모르신다면 "Civitai"를 구글 검색하세요) |

--quality 고급 -> 품질

| --repeat | 고급 -> 이미지 수 |

Multi Prompts (::) 여러 줄의 프롬프트를 사용하면 됩니다

| Prompt Weights | "I am (happy:1.5)"를 사용할 수 있습니다. <br> Fooocus는 A1111의 재가중치 알고리즘을 사용하여 사용자가 Civitai에서 프롬프트를 직접 복사하는 경우 ComfyUI보다 결과가 더 좋습니다. (프롬프트가 ComfyUI의 재가중치로 작성된 경우 사용자는 파일을 드래그하는 것을 선호하므로 프롬프트 텍스트를 복사할 가능성이 낮기 때문입니다) <br> 임베딩을 사용하려면 "(embedding:file_name:1.1)"을 사용할 수 있습니다 |

--no 고급 -> 네거티브 프롬프트

| --ar | 고급 -> 종횡비 |

InsightFace 입력 이미지 -> Image Prompt -> 고급 -> FaceSwap

| Describe | 입력 이미지 -> Describe |

다음은 LeonardoAI의 예제를 사용한 빠른 목록입니다:

LeonardoAI Fooocus

| - | - |

Prompt Magic 고급 -> 스타일 -> Fooocus V2

| 고급 샘플러 매개변수 (대비/선명도 등) | 고급 -> 고급 -> Sampling Sharpness / 등 |

사용자 친화적인 ControlNets 입력 이미지 -> Image Prompt -> 고급

또한, 고급 기능을 보려면 여기를 클릭하세요.

다운로드

Windows

다음 링크에서 Fooocus를 직접 다운로드할 수 있습니다:

>>> 다운로드하려면 여기를 클릭하세요 <<<

파일을 다운로드한 후 압축을 풀고 "run.bat"를 실행하세요.

!image

소프트웨어를 처음 실행하면 자동으로 모델을 다운로드합니다:

  1. 다양한 프리셋에 따라 기본 모델을 "Fooocus\models\checkpoints" 폴더에 다운로드합니다. 자동 다운로드를 원하지 않으면 미리 다운로드할 수 있습니다.
  2. inpaint를 사용하는 경우, 이미지를 처음 inpaint할 때 Fooocus의 자체 inpaint 제어 모델을 "Fooocus\models\inpaint\inpaint_v26.fooocus.patch" 파일로 다운로드합니다 (이 파일의 크기는 1.28GB입니다).

Fooocus 2.1.60 이후로는 runanime.batrunrealistic.bat도 제공됩니다. 이들은 다른 모델 프리셋입니다 (다른 모델이 필요하지만 자동으로 다운로드됩니다). 자세한 내용은 여기를 확인하세요.

  • --disable-preset-selection을 사용하여 브라우저에서 프리셋 선택을 비활성화합니다.
  • --always-download-new-model을 사용하여 프리셋 전환 시 누락된 모델을 다운로드합니다. 기본값은 해당 프리셋에 정의된 previousdefaultmodels로 대체되며, 터미널 출력도 참조하세요.

Fooocus 2.3.0 이후로는 브라우저에서 직접 프리셋을 전환할 수도 있습니다. 기본 동작을 변경하려면 다음 인수를 추가하세요:

!image

이미 이러한 파일이 있는 경우 위 위치에 복사하여 설치 속도를 높일 수 있습니다.

"MetadataIncompleteBuffer" 또는 "PytorchStreamReader" 가 표시되면 모델 파일이 손상된 것입니다. 모델을 다시 다운로드하세요.

다음은 16GB 시스템 RAM6GB VRAM(Nvidia 3060 노트북)을 갖춘 비교적 저사양 노트북에서의 테스트입니다. 이 머신에서의 속도는 반복당 약 1.35초입니다. 꽤 인상적입니다 – 요즘 3060이 탑재된 노트북은 일반적으로 매우 합리적인 가격입니다.

!image

또한, 최근 많은 다른 소프트웨어에서 Nvidia 드라이버 532 이상이 때때로 Nvidia 드라이버 531보다 10배 느리다고 보고합니다. 생성 시간이 매우 길다면 Nvidia 드라이버 531 노트북 또는 Nvidia 드라이버 531 데스크탑을 다운로드하는 것을 고려하세요.

최소 요구 사항은 4GB Nvidia GPU 메모리(4GB VRAM)8GB 시스템 메모리(8GB RAM)입니다. 이를 위해서는 Microsoft의 가상 스왑 기술을 사용해야 하며, 대부분의 경우 Windows 설치 시 자동으로 활성화되므로 별도로 조치할 필요가 없습니다. 그러나 확실하지 않거나 수동으로 비활성화한 경우(정말 그렇게 하는 사람이 있을까요?), 또는 "RuntimeError: CPUAllocator" 가 표시되면 다음에서 활성화할 수 있습니다:

<details> <summary>이미지 지침을 보려면 여기를 클릭하세요.</summary>

!image

그리고 여전히 "RuntimeError: CPUAllocator"가 표시되면 각 드라이브에 최소 40GB의 여유 공간이 있는지 확인하세요!

</details>

유사한 장치를 사용하지만 여전히 허용 가능한 성능을 얻지 못하는 경우 이슈를 열어주세요.

최소 요구 사항은 플랫폼에 따라 다릅니다.

일반적인 문제 및 문제 해결은 여기를 참조하세요.

Colab

(마지막 테스트 - 2024년 8월 12일, mashb1t 작성)

Colab 정보
Fooocus 공식

Colab에서 마지막 줄을 !python entrywithupdate.py --share --always-high-vram 또는 !python entrywithupdate.py --share --always-high-vram --preset anime 또는 !python entrywithupdate.py --share --always-high-vram --preset realistic로 수정하여 Fooocus 기본/애니메이션/리얼리스틱 에디션을 사용할 수 있습니다.

UI에서 프리셋을 변경할 수도 있습니다. 이로 인해 60초 후에 시간 초과가 발생할 수 있습니다. 이 경우 다운로드가 완료될 때까지 기다리거나, 프리셋을 초기로 변경한 후 선택한 프리셋으로 다시 변경하거나 페이지를 새로고침하세요.

이 Colab은 기본적으로 리파이너를 비활성화합니다. Colab 무료의 리소스가 상대적으로 제한적이기 때문입니다(그리고 일부 "큰" 기능(예: 이미지 프롬프트)은 무료 티어 Colab에서 연결이 끊어질 수 있습니다). 기본 텍스트-이미지 생성이 무료 티어 Colab에서 항상 작동하도록 보장합니다.

--always-high-vram을 사용하면 RAM에서 VRAM으로 리소스 할당을 전환하여 기본 T4 인스턴스에서 성능, 유연성 및 안정성 간의 전반적인 최상의 균형을 달성합니다. 자세한 내용은 여기를 참조하세요.

템플릿을 제공해 주신 camenduru님께 감사드립니다!

Linux (Anaconda 사용)

Anaconda/Miniconda를 사용하려면 다음을 실행하세요:

git clone https://github.com/lllyasviel/Fooocus.git cd Fooocus conda env create -f environment.yaml conda activate fooocus pip install -r requirements_versions.txt

그런 다음 모델을 다운로드합니다: 기본 모델을 "Fooocus\models\checkpoints" 폴더에 다운로드합니다. 또는 실행기를 사용하여 Fooocus가 자동으로 모델을 다운로드하도록 합니다:

conda activate fooocus python entrywithupdate.py

또는 원격 포트를 열려면 다음을 사용하세요:

conda activate fooocus python entrywithupdate.py --listen

python entrywithupdate.py --preset anime 또는 python entrywithupdate.py --preset realistic을 사용하여 Fooocus 애니메이션/리얼리스틱 에디션을 사용하세요.

Linux (Python Venv 사용)

Linux에 Python 3.10이 설치되어 있어야 하며, Python을 python3 명령으로 호출할 수 있고 venv 시스템이 작동한다고 가정합니다. 다음을 실행하세요:

git clone https://github.com/lllyasviel/Fooocus.git cd Fooocus python3 -m venv fooocusenv source fooocusenv/bin/activate pip install -r requirements_versions.txt

모델 다운로드에 대해서는 위 섹션을 참조하세요. 다음 명령으로 소프트웨어를 실행할 수 있습니다:

source fooocusenv/bin/activate python entrywith_update.py

또는 원격 포트를 열려면 다음을 사용하세요:

source fooocusenv/bin/activate python entrywith_update.py --listen

python entrywithupdate.py --preset anime 또는 python entrywithupdate.py --preset realistic을 사용하여 Fooocus 애니메이션/리얼리스틱 에디션을 사용하세요.

Linux (Python Venv 사용, AMD GPU)

AMD GPU 사용자는 여기를 참조하세요.

Mac

Mac 사용자는 여기를 참조하세요.

모델

기본 모델은 Stable Diffusion XL입니다. Fooocus 2.1.60부터는 runanime.bat를 사용할 때 animagine-xl이 기본 모델이고, runrealistic.bat를 사용할 때 realvisxlV40이 기본 모델입니다.

Fooocus는 또한 Civitai의 SDXL 모델을 지원합니다. 모델을 "Fooocus\models\checkpoints" 폴더에 넣으면 UI에 나타납니다.

듀얼 GPU

Fooocus는 듀얼 GPU를 지원합니다. 예를 들어, 두 개의 Nvidia RTX 4090이 있는 경우 다음을 사용할 수 있습니다:

python entrywithupdate.py --gpu-device 0 --async-cuda-allocation --disable-offload-from-vram

또는

python entrywithupdate.py --gpu-device 0 --gpu-device 1 --async-cuda-allocation --disable-offload-from-vram

고급 기능

고급 기능을 보려면 여기를 클릭하세요.

포크

포크를 보려면 여기를 클릭하세요.

감사의 말

Fooocus는 많은 훌륭한 오픈 소스 프로젝트에 의존합니다. 감사합니다!

원본 저장소: lllyasviel/Fooocus

라이선스: GPL-3.0

게재 제외를 원하시면 삭제 요청을 보내주세요.