# FLUX.2 klein 4B (이미지 모델)

> Apple silicon이 탑재된 Mac에서 로컬로 실행하는 FLUX.2 klein 4B: 4스텝으로 일러스트, 콘셉트 아트, 아이콘, 스프라이트를 만듭니다. 텍스트 투 이미지와 이미지 투 이미지를 지원합니다. Apache-2.0, 상업적 사용 가능. 8 GB Mac에서는 느립니다(512 px 이미지 한 장에 약 1분).

- Id: `aigd.image-flux2-klein-4b`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 이미지 모델
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.0.4 (2026-11-22 게시)
- 라이선스: Apache-2.0
- AI Game Dev 앱 필요: `>=0.20.0`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.image-flux2-klein-4b

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.image-flux2-klein-4b
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.image-flux2-klein-4b`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.20.0` | 최신 |
| 1.0.3 | 2026-11-18 | `>=0.20.0` | - |
| 1.0.2 | 2026-11-06 | `>=0.20.0` | - |
| 1.0.1 | 2026-10-13 | `>=0.20.0` | - |
| 1.0.0 | 2026-10-05 | `>=0.20.0` | - |

## 설명

````markdown
# FLUX.2 klein 4B (`aigd.image-flux2-klein-4b`)

**FLUX.2 [klein] 4B**는 Black Forest Labs가 만든 40억 매개변수의 작은 이미지 모델입니다. AI Game Dev는 이를 **Apple silicon이 탑재된 Mac**에서 제공하며, 이 모델은 **로컬 이미지 생성**([`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp))을 통해 Mac의 GPU(Metal)에서 로컬로 실행됩니다. 파일을 다운로드하고 나면 **4스텝**으로 일러스트, 아이콘, 스프라이트를 무료로 오프라인에서 만들 수 있습니다. Apache-2.0 라이선스이므로 상업적 사용이 가능합니다. Mac에서 작업하면서 클라우드 서비스 없이 이미지를 얻고 싶은 게임 개발자에게 적합합니다.

## 무엇을 만들 수 있나요

- 캐릭터, 소품, 장소의 일러스트와 콘셉트 아트.
- 아이템, 능력, UI용 아이콘.
- 스프라이트 스타일의 오브젝트와 캐릭터.
- 기존 이미지의 변형(이미지 투 이미지).

## 요청 예시

- "인벤토리에 쓸 빛나는 파란 크리스탈 아이콘을 만들어 주세요. 배경은 단색으로요."
- "우리 RPG에 쓸 아늑한 선술집 내부 콘셉트 아트를 만들어 주세요. 따뜻한 조명으로요."
- "카툰 스타일 슬라임 적의 스프라이트를 정면에서 본 모습으로 만들어 주세요."
- "이 일러스트를 더 밝고 더 다채로운 버전으로 만들어 주세요" (내 그림으로 이미지 투 이미지).

## 주요 특징

|  |  |
|---|---|
| 모델 | FLUX.2 [klein] 4B, rectified flow 트랜스포머, GGUF Q4_0 |
| 플랫폼 | Apple silicon이 탑재된 Mac 전용 (Metal) |
| 지원 작업 | 텍스트 투 이미지, 이미지 투 이미지 |
| 기본 크기 | 1024×1024 (최대 2048×2048); 8 GB Mac에서는 512×512 (최대 1024×1024) |
| 설정 | 4스텝, guidance 1, Euler 샘플러 |
| 텍스트 인코더 | Qwen3-4B |
| 상업적 사용 | 가능 (Apache-2.0) |

## 어떤 컴퓨터에서 쓸 수 있나요

| 컴퓨터 | 기본 크기 | 속도(이미지 한 장) |
|---|---|---|
| Apple silicon이 탑재된 Mac, 메모리 16 GB 이상 | 1024² | 아직 측정되지 않음 |
| Apple silicon이 탑재된 Mac, 메모리 8 GB | 512² (최대 1024²) | **느림**: 512²에서 약 1분, 1024²에서 약 4분 |

8 GB Mac mini M1에서 측정한 값이며, 보장이 아닌 추정치입니다. 8 GB Mac에서는 메모리를 디퓨전 모델에 남겨 두기 위해 텍스트 인코더와 오토인코더를 필요할 때 디스크에서 읽어 옵니다. 설치 후 첫 이미지는 약 20초 더 오래 걸립니다(macOS가 GPU 코드를 한 번 준비합니다). 이 모델은 현재 Mac에서만 제공되며, PC에서는 카탈로그의 다른 모델이 더 빠릅니다.

## 다운로드

이 패키지는 데이터만 포함합니다. 모델 파일 이름을 지정하며, 앱이 확인을 받은 뒤 파일을 다운로드하고 각 파일을 sha256으로 검증한 다음, 사용자의 컴퓨터에서 stable-diffusion.cpp로 실행합니다.

5.29 GB, 파일 3개, 각각 Hugging Face 커밋에 고정:

| 파일 | 출처 | 크기 |
|---|---|---:|
| `flux-2-klein-4b-Q4_0.gguf` (디퓨전 모델) | [`leejet/FLUX.2-klein-4B-GGUF`](https://huggingface.co/leejet/FLUX.2-klein-4B-GGUF) | 2.46 GB |
| `Qwen3-4B-Q4_K_M.gguf` (텍스트 인코더) | [`unsloth/Qwen3-4B-GGUF`](https://huggingface.co/unsloth/Qwen3-4B-GGUF) | 2.50 GB |
| `flux2-vae.safetensors` (오토인코더) | [`Comfy-Org/Flux-2-Klein-4B`](https://huggingface.co/Comfy-Org/Flux-2-Klein-4B) | 0.34 GB |

## 라이선스

Apache-2.0. 상업적 사용이 허용됩니다. 이 모델은 **4B** 모델이며, 더 큰 FLUX.2 klein 9B는 비상업적 라이선스를 가지고 있어 카탈로그에 포함되지 않습니다.

- FLUX.2 [klein] 4B © Black Forest Labs — [모델 카드](https://huggingface.co/black-forest-labs/FLUX.2-klein-4B), Apache-2.0; GGUF 출처 [`leejet/FLUX.2-klein-4B-GGUF`](https://huggingface.co/leejet/FLUX.2-klein-4B-GGUF), Apache-2.0.
- 텍스트 인코더 Qwen3-4B © Qwen team — [모델 카드](https://huggingface.co/Qwen/Qwen3-4B), Apache-2.0; GGUF 출처 [`unsloth/Qwen3-4B-GGUF`](https://huggingface.co/unsloth/Qwen3-4B-GGUF), Apache-2.0.
- FLUX.2 오토인코더 © Black Forest Labs — [Apache-2.0](https://github.com/black-forest-labs/flux2#flux2-autoencoder)에 따라 배포됨; 다운로드 출처 [`Comfy-Org/Flux-2-Klein-4B`](https://huggingface.co/Comfy-Org/Flux-2-Klein-4B), Apache-2.0.

모든 파일은 Hugging Face에서 다운로드합니다. AI Game Dev는 이 파일들을 직접 호스팅하지 않습니다.
````
