egotoadcitadel/palette-from-image-ai
AI coloring palette-from-image generator for designers and pixel artists — pull a clean named palette straight from any image, no subscription or cloud upload.
🎨 Palette‑From‑Image‑AI란?
Windows 전용의 휴대용 데스크톱 프로그램으로, 사진, 스크린샷, 게임 텍스처, 그림 등 모든 이미지를 바로 사용할 수 있는 컬러 팔레트로 변환합니다. 오프라인으로 추론하며, 온디바이스 비전 모델이 먼저 이미지를 의미 있는 영역(하늘, 지면, 피사체 등)으로 세그먼테이션한 다음, 지각적 거리 메트릭(LAB 공간의 CIEDE2000)을 사용하여 색상을 클러스터링합니다. 결과는 5~16개의 스와치로 구성된 작은 순서 집합이며, 각각 자동으로 레이블(베이스, 액센트, 섀도우, 하이라이트)이 지정되고 HEX, CSS 변수, Adobe ASE, GIMP GPL, JSON, PNG 스와치 시트, SVG 등 12가지 형식으로 내보낼 수 있습니다.
⚙️ 핵심 아키텍처(README에 설명됨)
| 구성 요소 | 역할 |
|---|---|
| 온디바이스 비전 모델 | 입력 이미지의 의미론적 세그먼테이션을 수행합니다. |
| 지각적 색상 양자화기 | 원시 RGB가 아닌 CIEDE2000(LAB)을 사용하여 색상을 클러스터링합니다. |
| 영역 샘플러 | 세그먼트별로 색상을 샘플링하고 면적으로 가중치를 두어 각 영역에 공정한 영향을 줍니다. |
| 하모니 엔진 | 필요에 따라 팔레트를 색상 하모니 체계(유사, 보색, 삼색, 분할 보색)에 스냅합니다. |
| 역할 태거 | 기능 태그(베이스, 액센트, 섀도우, 하이라이트, 뉴트럴)를 자동으로 할당합니다. |
| 내보내기 계층 | 업계 표준 스와치 형식을 포함한 12가지 파일 형식으로 팔레트를 씁니다. |
| GPU 경로(DX12) | 큰 이미지를 위한 선택적 DirectX 12 컴퓨트 가속(4K에서 약 1초). |
| CLI 래퍼 | 명령줄 인수를 통한 스크립팅을 허용합니다. |
이 모든 것이 단일 **.exe**에 번들로 포함되어 있습니다. 설치 프로그램도, 런타임 종속성도, 네트워크 트래픽도 없습니다.
🚀 주요 기능(사용자 대상)
| 기능 | 설명 |
|---|---|
| 영역 인식 추출 | 의미론적 영역별로 색상을 샘플링하여 단순 픽셀 빈도 방법에서 흔히 발생하는 중복 스와치를 방지합니다. |
| 지각적 클러스터링 | CIEDE2000을 사용하므로 인간에게 동일하게 보이는 색상이 병합됩니다. |
| 역할 태깅 | 각 스와치에 레이블(베이스, 액센트, 섀도우, 하이라이트)이 지정되며 편집할 수 있습니다. |
| 하모니 제약 | 색상 체계를 선택하면 엔진이 팔레트를 해당 체계로 조정합니다. |
| 12가지 내보내기 형식 | HEX, RGB, HSL, LAB, ASE, GPL, ACO, CSS 변수, JSON, PNG 시트, SVG 시트, SKETCH. |
| 배치 모드 | 폴더를 드롭하면 앱이 이미지당 하나의 팔레트를 생성합니다(멀티스레드). |
| 팔레트 비교 | 두 팔레트를 비교하여 색상 델타를 확인할 수 있습니다. 아트 디렉션 추적에 유용합니다. |
| 스와치 잠금 | 색상(예: 브랜드 색상)을 고정하고 나머지를 다시 추출합니다. |
| 아이볼 샘플러 | 픽셀을 클릭하여 정확한 값을 스와치로 추가합니다. |
| GPU 토글 | 고해상도 이미지 처리를 위해 DirectX 12 컴퓨트를 활성화합니다. |
| 휴대용 프로필 | 설정이 실행 파일 옆에 저장됩니다. 폴더를 USB 스틱에 옮겨도 모든 것이 작동합니다. |
| CLI 모드 | 스크립트 사용: palette-from-image-ai.exe --input foo.png --count 8 --format css --out palette.css. |
| 감시 폴더 | 모니터링되는 디렉토리에 새 파일을 자동으로 처리합니다. |
📦 시작하기(README의 빠른 시작 단계)
- GitHub 랜딩 페이지에서 zip을 다운로드합니다.
.exe와models/폴더가 포함되어 있습니다. - 아카이브 전체를 제어할 수 있는 폴더에 압축을 풉니다(설치 프로그램 불필요).
.exe를 실행합니다. 첫 실행 시 작은 셰이더 캐시가 생성됩니다(약 3초).- 이미지를 창에 드롭하거나 파일 → 이미지 열기를 사용합니다.
- 스와치 수(5~16)를 조정하고 하모니 모드를 선택하고 유지하려는 색상을 잠급니다.
- 필요한 형식으로 내보냅니다. HEX는 원클릭, 스와치 오른쪽 클릭으로 값을 복사할 수 있습니다.
일반적인 종단 간 시간: 1분 미만, GPU 가속 사용 시 4K 이미지의 경우 약 1.2초입니다.
🛠️ 시스템 요구 사항(명시된 대로)
| 최소 | 권장 |
|---|---|
| Windows 10 21H2(64비트) | Windows 11 23H2+ |
| 4코어 CPU, SSE4.2 | 8코어 CPU, AVX2 |
| 4 GB RAM | 16 GB RAM |
| 내장 GPU(DX11) | 전용 DX12 GPU, 4 GB VRAM |
| 450 MB 여유 디스크 | 1.2 GB 여유(SSD) |
추가 런타임이 필요 없습니다(.NET, Python, Node 없음). 앱은 사용자 공간에서 완전히 실행됩니다.
📚 일반적인 사용 사례
| 시나리오 | Palette‑From‑Image‑AI가 적합한 이유 |
|---|---|
| 게임 에셋 파이프라인 – 셰이더용 ASE 팔레트 필요. | 직접 ASE 내보내기, 영역 인식 색상, 스프라이트 폴더 일괄 처리. |
| UI/UX 디자인 – CSS용 색상 변수 생성. | CSS 변수 내보내기, 하모니 모드, 역할 태그(베이스/액센트). |
| 브랜드 일관성 아트 디렉션 – 브랜드 색상을 고정하면서 팔레트 재도출. | 스와치 잠금 + 재추출, 팔레트 비교로 시간에 따른 변경 확인. |
| 보안 스튜디오용 오프라인 워크플로우 – 자산 업로드 불가. | 완전 오프라인, 텔레메트리 없음, 휴대용 폴더. |
| 스크립팅/CI – 팔레트 자동 생성. | CLI 모드 및 감시 폴더 자동화. |
📌 제한 사항 및 알려진 문제(README에서)
- 첫 실행 시 이진 파일이 서명되지 않았기 때문에 SmartScreen 경고가 표시됩니다.
- 매우 큰 TIFF(200 MP 초과)는 아직 지원되지 않습니다. 먼저 축소하세요.
- 네트워크 드라이브에서는 배치 모드가 중단될 수 있습니다. 최상의 속도를 위해 로컬에 복사하세요.
- GPU 토글은 DX12 컴퓨트 큐가 없는 머신에서는 비활성화됩니다.
- 평평하고 채도가 높은 이미지는 중복 제거 임계값을 낮춰야 할 수 있습니다(설정 → 고급에서 조정).
📜 라이선스 및 기여
- MIT 라이선스 – 개인, 상업, 교육용으로 무료. 저작자 표시는 권장되지만 필수는 아닙니다.
- 저장소에는 컴파일된 실행 파일과 모델 파일이 포함되어 있습니다. 소스 코드는 언급되지 않았으므로 기여는 문제 보고나 새 기능 요청(예: 로드맵에 있는 Linux CLI 빌드)으로 제한될 가능성이 높습니다.
🎯 결론
Palette‑From‑Image‑AI는 온디바이스 비전 모델과 지각적 색상 클러스터링을 활용하여 모든 이미지에서 고품질의 역할 인식 컬러 팔레트를 생성하는 진정한 완전 오프라인 Windows 애플리케이션입니다. 강점은 영역 인식 추출, 다양한 내보내기 옵션, 휴대용 설치 불필요한 특성에 있으며, 온라인 서비스에 의존하지 않고 안정적인 팔레트가 필요한 아티스트, UI 디자이너, 게임 개발자에게 유용합니다.
관련
- 프로젝트
- 프로젝트