allenk/GeminiWatermarkTool

Gemini Watermark Tool – 개요

GeminiWatermarkTool은 Google의 Gemini AI 모델이 생성한 이미지(및 보조 바이너리를 통한 동영상)에 추가되는 가시적인 워터마크를 제거하는 소형 크로스 플랫폼 프로그램입니다. 일반적인 생성형 인페인팅이 아닌 결정론적 리버스-알파 블렌딩(deterministic reverse-alpha-blending) 알고리즘을 사용하여 원래의 픽셀 데이터를 가능한 한 정확하게 복구합니다. 옵션으로 제공되는 경량 신경망 디노이저(FDnCNN)를 통해 잔여 아티팩트를 제거할 수 있습니다.

주요 기능 (README 설명 기준)

카테고리	상세 내용
핵심 알고리즘	Gemini 워터마크를 위해 보정된 48×48 및 96×96 마스크를 사용하는 리버스-알파 블렌딩.
워터마크 프로필	최신 Gemini 3.5 레이아웃(36×36 또는 96×96 로고)을 지원하며, 이전 3.5 미만 레이아웃으로 자동 전환됩니다.
탐지	신뢰도 점수가 포함된 3단계 정규화 상호 상관(NCC); 워터마크가 없는 이미지는 건너뜁니다.
CLI	단일 파일, 배치 디렉토리 및 다중 파일 모드. 자동 레거시 전환, 설정 가능한 `--threshold`, `--force`, `--legacy` 및 개별 종료 코드(0 = 성공, 1 = 건너뜀, 2 = 오류).
GUI	실시간 전/후 미리보기, 사용자 정의 영역 선택, 인페인팅(NS, TELEA, Soft), AI 디노이즈, 배치 썸네일 및 키보드 단축키를 갖춘 드래그 앤 드롭 데스크톱 앱.
AI 지원 클린업	Vulkan GPU 가속을 통해 NCNN으로 실행되는 FDnCNN(20계층 합성곱 신경망). GPU가 없는 경우 CPU로 전환됩니다.
동영상 지원	프레임별로 동일한 리버스-알파 수학을 적용하는 별도의 VeoWatermarkRemover 바이너리(v0.6.1). 적응형 프레임별 알파, 오디오 패스스루 및 옵션 AI 디노이즈 지원.
크로스 플랫폼	Windows, Linux, macOS (Intel + Apple Silicon) 및 Android CLI용 사전 빌드된 포터블 실행 파일.
에이전트 통합	MCP 서버 및 Claude Code 스킬(`gwt-integrations`)을 통해 AI 에이전트 파이프라인을 위한 4가지 도구 호출(`remove_watermark`, `detect_watermark`, `batch_process`, `get_tool_info`)을 제공합니다.
라이선스	MIT – 상업적 이용 무료, 재배포 시 출처 표기 필요.

주요 사용 사례

Gemini 생성 이미지 정리: 게시 또는 아카이브 전에 생성형 채우기에 의존하지 않고 원래의 디테일을 보존하며 정리합니다.
배치 처리: 일부 파일에 워터마크가 포함되지 않았을 수 있는 대량의 스크린샷 또는 내보낸 에셋 폴더를 처리합니다.
자동화 스크립트 통합: CLI의 종료 코드와 MCP로 노출된 API를 사용하여 CI 파이프라인 또는 콘텐츠 모더레이션 봇에 통합합니다.
동영상 후처리: 보조 VeoWatermarkRemover 바이너리를 사용하여 Gemini 3.5 "다이아몬드" 워터마크가 포함된 녹화물을 처리합니다.

빠른 시작 (CLI)

# 단일 이미지, 자동 탐지
GeminiWatermarkTool image.png

# 탐지에 실패하더라도 강제 처리
GeminiWatermarkTool --force image.png -o clean.png

# 폴더 전체 배치 처리 → 출력 폴더
GeminiWatermarkTool -i./watermarked/ -o./clean/

# 레거시 프로필만 사용
GeminiWatermarkTool --legacy old_image.png

빠른 시작 (GUI)

실행 파일을 실행합니다 (설치 필요 없음).
이미지 또는 폴더를 창 위로 드래그 앤 드롭합니다.
도구가 워터마크를 자동 탐지합니다. 필요한 경우 영역을 조정하거나 다른 프로필을 선택합니다.
X를 눌러 적용, V를 눌러 전/후 보기 전환, Z를 눌러 되돌리기를 수행합니다.
동영상의 경우, 별도의 VeoWatermarkRemover 바이너리를 실행하고 MP4 파일을 드롭합니다.

왜 중요한가

결정론적 복원: 콘텐츠를 환각하는 AI 인페인팅 도구와 달리, 이 방법은 워터마크를 추가한 정확한 블렌딩을 수학적으로 역전시켜 원래 이미지가 변경되지 않은 경우 충실한 복원을 제공합니다.
경량 및 오프라인: 옵션으로 GPU 가속 디노이징을 제공하는 단일 포터블 실행 파일로, 클라우드 서비스가 필요 없습니다.
최신 상태 유지: 최신 Gemini 3.5 워터마크 레이아웃을 지원하며 이전 이미지에 대한 자동 전환 기능을 제공합니다.
확장성: MCP를 통해 노출되어 향후 AI 에이전트(Claude, Cursor 등)가 직접 호출할 수 있습니다.

더 많은 정보

소스 및 릴리스 – https://github.com/allenk/GeminiWatermarkTool
동영상 제거 도구 – https://github.com/allenk/VeoWatermarkRemover
기술 심층 분석 – README에 링크된 Medium 기사.
데모 영상 – https://www.youtube.com/watch?v=0jux3AJVb2Q

요약

GeminiWatermarkTool은 Google의 Gemini 모델이 출력물에 찍는 독점 워터마크를 제거하는 매우 구체적인 AI 관련 문제에 집중하는 진정한 오픈 소스 유틸리티입니다. 수학적으로 정확한 리버스-알파 알고리즘과 옵션 AI 기반 디노이징을 결합하고, CLI와 세련된 GUI를 모두 제공하며, AI 에이전트 통합을 위한 API까지 제공합니다. Gemini 생성 미디어를 정리하기 위한 신뢰할 수 있는 오프라인 방법을 찾는 모든 사람에게 이 저장소는 바로 적합한 도구입니다.