wiltodelta/remove-ai-watermarks

Remove visible and invisible AI watermarks from images and video, and AI provenance metadata from images, video, and audio. Python library, CLI, and agent skill for SynthID, C2PA, EXIF, IPTC, XMP, and common generative-AI marks.

개요

remove‑ai‑watermarks는 소유한 미디어에서 AI 생성 출처 신호를 감지하고 제거할 수 있는 Python 라이브러리이자 명령줄 도구입니다. 정지 이미지와 비디오 파일 모두에서 작동하며 다음을 수행할 수 있습니다:

공급업체 워터마크(예: Google Gemini sparkle, Doubao, Sora, Veo 등)를 식별합니다.
OpenCV, MI‑GAN 또는 LaMa로 해당 영역을 인페인팅하여 보이는 표시를 제거합니다.
확산 기반 재생성을 사용하여 보이지 않는 픽셀 수준 워터마크(SynthID)를 지웁니다 – CUDA 전용 작업입니다.
이미지 및 비디오 컨테이너에서 C2PA, EXIF, XMP, IPTC 및 공급업체별 태그와 같은 AI 관련 메타데이터를 제거합니다.
단일 파일 또는 전체 디렉터리를 처리하며, 이미지(identify, visible, metadata, invisible, all) 및 비디오(video identify, video visible, video invisible, video all, video batch)에 대한 별도의 명령이 있습니다.

이 프로젝트는 직접 만든 콘텐츠를 위한 연구 수준의 합법적 사용 유틸리티로 자리 잡고 있습니다. 제3자 저작권 워터마크를 대상으로 하지 않습니다.

주요 기능

기능	설명	일반적인 명령	GPU 요구 사항
출처 감지	알려진 보이는 표시와 포함된 AI 메타데이터를 검사합니다.	`remove-ai-watermarks identify img.png`	아니요
보이는 워터마크 제거	감지된 로고를 마스킹하고 채웁니다(OpenCV, MI‑GAN, LaMa).	`remove-ai-watermarks visible img.png -o clean.png`	아니요(학습된 백엔드의 경우 선택 사항)
보이지 않는(SynthID) 제거	확산 모델로 전체 이미지를 재생성하여 숨겨진 픽셀 워터마크를 방해합니다.	`remove-ai-watermarks invisible img.png -o clean.png`	예 – CUDA GPU
메타데이터 제거	이미지/비디오를 다시 인코딩하지 않고 C2PA, EXIF, XMP, IPTC, TC260 AIGC 태그 등을 제거합니다.	`remove-ai-watermarks metadata img.png --remove -o clean.png`	아니요
비디오 전반 지원	MP4, MOV, MKV, WebM, AVI, FLV에 대해 동일한 기능을 제공하며 폴더를 일괄 처리할 수도 있습니다.	`remove-ai-watermarks video all input.mp4 -o clean.mp4`	모드에 따라 다름(보이지 않는 경우 GPU 필요)
확장 가능한 추가 기능	선택적 pip 추가 기능으로 필요한 부분만 설치합니다(`[visible]`, `[video]`, `[qwen‑zimage]`, `[migan]`, …).	`uv tool install "remove-ai-watermarks[visible]"`	다양함

사용 방법

설치 – 기본 패키지는 메타데이터 명령을 제공합니다. 필요한 기능에 따라 추가 기능을 설치하세요. 예:

uv tool install remove-ai-watermarks               # 메타데이터만
uv tool install "remove-ai-watermarks[visible]"   # 보이는 워터마크 제거
uv tool install "remove-ai-watermarks[qwen-zimage]"  # 보이지 않는 워터마크 제거 (CUDA)

CLI 명령 실행 – 예:

# AI 출처 감지
remove-ai-watermarks identify photo.jpg

# 보이는 Gemini 워터마크와 메타데이터 제거
remove-ai-watermarks visible photo.jpg -o clean.jpg

# 메타데이터만 제거
remove-ai-watermarks metadata photo.jpg --remove -o clean.jpg

# 숨겨진 SynthID 워터마크 제거 (GPU 필요)
remove-ai-watermarks invisible photo.jpg -o clean.jpg --force

Python API – 패키지를 가져와 고수준 함수를 호출합니다:

import remove_ai_watermarks as raiw

# 표시 감지
info = raiw.identify("photo.jpg")

# 모든 것 제거 (보이는 + 보이지 않는 + 메타데이터)
result = raiw.remove_all("photo.jpg", "clean.jpg")
print(result.visible_status, result.invisible_status)

누가 필요할까요?

AI 모델로 이미지나 비디오를 생성하고 공급업체 브랜딩 없이 게시하려는 콘텐츠 제작자.
실험을 위해 미디어에서 신호를 깔끔하게 분리할 방법이 필요한 AI 출처를 연구하는 연구자.
다운스트림 처리(예: 학습 데이터 준비, 아카이빙)를 위해 "워터마크 없는" 자산을 제공해야 하는 파이프라인을 구축하는 개발자.

제한 사항 및 안전 참고 사항

이 도구는 소유한 미디어에서만 작동합니다. 제3자 유료 콘텐츠를 보호하는 워터마크 제거는 명시적으로 피합니다.
보이지 않는 워터마크 제거는 확산 모델에 의존하며 손실이 있습니다 – 재생성된 이미지는 원본과 미묘하게 다를 수 있습니다.
일부 관할권(예: 중국)에서는 AI 출처 표시 제거를 제한합니다. 저장소에는 법적 안전 참고 사항이 포함되어 있습니다.
감지는 지원되는 공급업체 목록(Google, Microsoft, Doubao, Sora, Veo 등)으로 제한됩니다. 새롭거나 사용자 정의 워터마크는 코드베이스에 추가되지 않는 한 인식되지 않습니다.
보이지 않는 워터마크 제거는 GPU 전용입니다. CPU 대체는 제공되지 않습니다.

라이선스 및 커뮤니티

패키지는 오픈 소스 라이선스로 PyPI에 게시됩니다(LICENSE 참조).
README에는 CI 상태 배지, 다운로드 통계, 스폰서 버튼이 표시됩니다.
프로젝트는 소수의 문서 파일(docs/cli.md, docs/installation.md, docs/legal-and-safety.md 등)과 테스트 스위트를 유지 관리합니다.

빠른 요약

remove-ai-watermarks는 이미지와 비디오에서 보이는 AI 출처 신호와 숨겨진 AI 출처 신호를 모두 감지하고 제거할 수 있는 명령줄 및 프로그래밍 방식 액세스를 제공하는 진정하고 활발히 유지 관리되는 Python 라이브러리입니다. 합법적이고 자체 생성된 콘텐츠에 초점을 맞추며, 가장 어려운 보이지 않는 워터마크를 위한 선택적 GPU 가속 확산을 제공합니다.