✓ Verified 💻 Development ✓ Enhanced Data

Deai Image

Detect and remove AI fingerprints from AI-generated images.

Rating
4.8 (378 reviews)
Downloads
32,806 downloads
Version
1.0.0

Overview

Detect and remove AI fingerprints from AI-generated images.

Complete Documentation

View Source →

AI Image De-Fingerprinting Skill

Comprehensive CLI for removing AI detection patterns from AI-generated images. Transforms detectable AI images into human-camera-like photographs using multiple processing techniques.

Supported Models: Midjourney, DALL-E 3, Stable Diffusion, Flux, Firefly, Leonardo, and more.

Quick Start

bash
# Basic processing (medium strength)
python scripts/deai.py input.png

# Specify output file
python scripts/deai.py input.png -o output.jpg

# Adjust processing strength
python scripts/deai.py input.png --strength heavy

# Only strip metadata (fastest)
python scripts/deai.py input.png --no-metadata

# Batch process directory
python scripts/deai.py input_dir/ --batch

# Pure Bash version (no Python needed)
bash scripts/deai.sh input.png output.jpg


How It Works

AI-generated images contain multiple detection layers:

Detection Vectors

  • Metadata: EXIF tags revealing generation tool, C2PA watermarks
  • Frequency Domain: DCT coefficient patterns unique to diffusion models
  • Pixel Patterns: Over-smoothness, unnatural noise distribution
  • Visual Features: Perfect lighting, repetitive textures

Processing Pipeline

Our de-fingerprinting pipeline applies 7 transformation stages:

text
Input → Metadata Strip → Grain Addition → Color Adjustment → 
Blur/Sharpen → Resize Cycle → JPEG Recompress → Final Metadata Clean → Output

#### Stage Details

StagePurposeTechnique
Metadata StripRemove EXIF/C2PA/JUMBF tagsExifTool
Grain AdditionAdd camera sensor noisePoisson/Gaussian noise overlay
Color AdjustmentBreak color distribution patternsContrast/saturation/brightness tweak
Blur/SharpenDisrupt edge detection patternsGaussian blur + unsharp mask
Resize CycleIntroduce resampling artifactsDownscale → upscale with Lanczos
JPEG RecompressAdd compression artifactsQuality 75 → 95 cycle
Final CleanEnsure no metadata leakageExifTool re-run

Processing Strength

Choose strength based on detection risk vs quality tradeoff:

StrengthDescriptionSuccess RateQuality Loss
lightMinimal processing, preserve quality35-45%Very low
mediumBalanced (default)50-65%Low
heavyAggressive processing65-80%Medium
Success rate = percentage of images passing common AI detectors (Hive, Illuminarty, AI or Not)


Usage Examples

Single Image Processing

bash
# Default medium strength
python scripts/deai.py ai_portrait.png

# Light processing for high-quality images
python scripts/deai.py artwork.png --strength light -o clean_artwork.jpg

# Heavy processing for stubborn detection
python scripts/deai.py midjourney_out.png --strength heavy

Batch Processing

bash
# Process entire directory
python scripts/deai.py ./ai_images/ --batch -o ./cleaned/

# Batch with specific strength
python scripts/deai.py ./gallery/*.png --batch --strength heavy

Metadata-Only Mode

bash
# Only strip metadata (instant, no quality loss)
python scripts/deai.py image.jpg --no-metadata

Using Bash Version

bash
# No Python/Pillow needed, pure ImageMagick + ExifTool
bash scripts/deai.sh input.png output.jpg

# Specify strength
bash scripts/deai.sh input.png output.jpg heavy


Dependencies

Required

  • ImageMagick (7.0+) — Image processing engine
  • ExifTool — Metadata manipulation
  • Python 3.7+ (for deai.py)
  • Pillow (Python imaging library)
  • NumPy (for deai.py)

Check Installation

bash
bash scripts/check_deps.sh

This will verify all dependencies and provide installation commands if missing.

Manual Installation

Debian/Ubuntu:

bash
sudo apt update
sudo apt install -y imagemagick libimage-exiftool-perl python3 python3-pip
pip3 install Pillow numpy

macOS:

bash
brew install imagemagick exiftool python3
pip3 install Pillow numpy

Fedora/RHEL:

bash
sudo dnf install -y ImageMagick perl-Image-ExifTool python3-pip
pip3 install Pillow numpy


Command Reference

deai.py (Python Version)

text
python scripts/deai.py <input> [options]

Arguments:
  input                 Input image file or directory (batch mode)

Options:
  -o, --output FILE     Output file path (default: input_deai.jpg)
  --strength LEVEL      Processing strength: light|medium|heavy (default: medium)
  --no-metadata         Only strip metadata, skip image processing
  --batch               Process entire directory
  -q, --quiet           Suppress progress output
  -v, --verbose         Show detailed processing steps

Examples:
  python scripts/deai.py image.png
  python scripts/deai.py image.png -o clean.jpg --strength heavy
  python scripts/deai.py folder/ --batch

deai.sh (Bash Version)

text
bash scripts/deai.sh <input> <output> [strength]

Arguments:
  input                 Input image file
  output                Output file path
  strength              light|medium|heavy (default: medium)

Examples:
  bash scripts/deai.sh input.png output.jpg
  bash scripts/deai.sh input.png output.jpg heavy


Understanding Detection

Common AI Detectors

DetectorMethodBypass Rate
Hive ModerationDeep learning model50-70% (medium)
IlluminartyComputer vision analysis60-75% (medium)
AI or NotBinary classification55-70% (medium)
SynthIDPixel-level watermark35-50% (heavy)
C2PA VerifyMetadata check100% (metadata strip)

What This Skill Cannot Do

Not a Silver Bullet:

  • Cannot guarantee 100% bypass of all detectors
  • Advanced detectors (SynthID) require more aggressive processing
  • New detection methods may emerge
Limitations:
  • Processing reduces image quality (tradeoff necessary)
  • Some detectors use multiple layers (metadata + pixel + frequency)
  • Extremely aggressive processing may introduce visible artifacts
What It DOES Do:
  • Significantly reduces detection probability (40-80%)
  • Removes metadata watermarks (100% effective)
  • Maintains reasonable visual quality
  • Batch processes entire collections

Verification Workflow

  • Process Image:
bash
python scripts/deai.py ai_image.png -o clean.jpg --strength medium
  • Test on Multiple Detectors:
  • Hive Moderation
  • Illuminarty
  • AI or Not
  • If Still Detected:
  • Increase strength: --strength heavy
  • Try multiple passes
  • Manual touch-ups (add slight noise in photo editor)
  • Quality Check:
  • Compare original vs processed
  • Ensure no visible artifacts
  • Verify colors/details preserved

Advanced Usage

Custom Processing Pipeline

Edit scripts/deai.py to adjust parameters:

python
# Noise strength (line ~80)
noise = np.random.normal(0, 3, img_array.shape)  # Increase 3 → 5 for more grain

# Contrast adjustment (line ~95)
enhancer.enhance(1.05)  # Increase 1.05 → 1.08 for stronger effect

# JPEG quality (line ~120)
img.save(temp_path, "JPEG", quality=80)  # Decrease 80 → 70 for more compression

Combining with External Tools

bash
# Step 1: De-fingerprint
python scripts/deai.py ai_gen.png -o step1.jpg

# Step 2: Add subtle texture overlay (GIMP/Photoshop)
# (Manual step)

# Step 3: Re-strip metadata
exiftool -all= step1_edited.jpg


Best Practices

For Social Media

  • Use medium strength (good balance)
  • Output as JPEG (universal compatibility)
  • Test on platform's upload flow before posting

For Professional Use

  • Start with light (preserve quality)
  • Manual review each output
  • Keep originals in secure storage
  • Document processing steps

For Research/Testing

  • Use heavy for stress testing
  • Compare multiple detectors
  • Document success/failure patterns

Legal & Ethical Notice

⚠️ Use Responsibly:

This tool is intended for:

  • ✅ Personal creative projects
  • ✅ Academic research on AI detection
  • ✅ Security testing (authorized)
  • ✅ Understanding detection mechanisms
DO NOT use for:
  • ❌ Fraud or deception
  • ❌ Impersonating human creators
  • ❌ Bypassing platform policies without authorization
  • ❌ Creating misleading content
Legal Risks:
  • Some jurisdictions (e.g., COPIED Act 2024) may restrict watermark removal
  • Platform terms of service often prohibit AI content masking
  • Commercial use may have additional legal requirements
You are responsible for compliance with applicable laws and terms of service.


Troubleshooting

"Command not found: exiftool"

bash
# Install ExifTool
sudo apt install libimage-exiftool-perl  # Debian/Ubuntu
brew install exiftool                     # macOS

"ImportError: No module named PIL"

bash
pip3 install Pillow numpy

"ImageMagick policy.xml blocks operation"

bash
# Edit /etc/ImageMagick-7/policy.xml
# Change: <policy domain="coder" rights="none" pattern="PNG" />
# To:     <policy domain="coder" rights="read|write" pattern="PNG" />

Processing is slow on large images

bash
# Pre-resize before processing
magick large.png -resize 2048x2048\> resized.png
python scripts/deai.py resized.png

Output looks too grainy/noisy

bash
# Use light strength
python scripts/deai.py input.png --strength light


Development

Running Tests

bash
# Test dependency check
bash scripts/check_deps.sh

# Test single image (verbose)
python scripts/deai.py test_images/sample.png -v

# Test batch mode
mkdir test_output
python scripts/deai.py test_images/ --batch -o test_output/

Contributing

Improvements welcome! Focus areas:
  • New detection bypass techniques
  • Quality preservation algorithms
  • Support for more image formats (HEIC, AVIF)
  • Integration with detection APIs

References

Detection Research:

  • Hu, Y., et al. (2024). "Stable signature is unstable: Removing image watermark from diffusion models." arXiv:2405.07145
  • IEEE Spectrum: UnMarker tool analysis
Open Source Projects: Detection Tools:

Version: 1.0.0 License: MIT (for educational/research use) Maintainer: voidborne-d Last Updated: 2026-02-23

Installation

Terminal bash

openclaw install deai-image
    
Copied!

💻Code Examples

bash scripts/deai.sh input.png output.jpg

bash-scriptsdeaish-inputpng-outputjpg.txt
---

## How It Works

AI-generated images contain multiple detection layers:

### Detection Vectors
1. **Metadata**: EXIF tags revealing generation tool, C2PA watermarks
2. **Frequency Domain**: DCT coefficient patterns unique to diffusion models
3. **Pixel Patterns**: Over-smoothness, unnatural noise distribution
4. **Visual Features**: Perfect lighting, repetitive textures

### Processing Pipeline

Our de-fingerprinting pipeline applies **7 transformation stages**:

Blur/Sharpen → Resize Cycle → JPEG Recompress → Final Metadata Clean → Output

blursharpen--resize-cycle--jpeg-recompress--final-metadata-clean--output.txt
#### Stage Details

| Stage | Purpose | Technique |
|-------|---------|-----------|
| **Metadata Strip** | Remove EXIF/C2PA/JUMBF tags | ExifTool |
| **Grain Addition** | Add camera sensor noise | Poisson/Gaussian noise overlay |
| **Color Adjustment** | Break color distribution patterns | Contrast/saturation/brightness tweak |
| **Blur/Sharpen** | Disrupt edge detection patterns | Gaussian blur + unsharp mask |
| **Resize Cycle** | Introduce resampling artifacts | Downscale → upscale with Lanczos |
| **JPEG Recompress** | Add compression artifacts | Quality 75 → 95 cycle |
| **Final Clean** | Ensure no metadata leakage | ExifTool re-run |

---

## Processing Strength

Choose strength based on detection risk vs quality tradeoff:

| Strength | Description | Success Rate | Quality Loss |
|----------|-------------|--------------|--------------|
| `light` | Minimal processing, preserve quality | 35-45% | Very low |
| `medium` | Balanced (default) | 50-65% | Low |
| `heavy` | Aggressive processing | 65-80% | Medium |

**Success rate** = percentage of images passing common AI detectors (Hive, Illuminarty, AI or Not)

---

## Usage Examples

### Single Image Processing

bash scripts/deai.sh input.png output.jpg heavy

bash-scriptsdeaish-inputpng-outputjpg-heavy.txt
---

## Dependencies

### Required
- **ImageMagick** (7.0+) — Image processing engine
- **ExifTool** — Metadata manipulation
- **Python 3.7+** (for deai.py)
- **Pillow** (Python imaging library)
- **NumPy** (for deai.py)

### Check Installation

bash scripts/check_deps.sh

bash-scriptscheckdepssh.txt
This will verify all dependencies and provide installation commands if missing.

### Manual Installation

**Debian/Ubuntu:**

pip3 install Pillow numpy

pip3-install-pillow-numpy.txt
---

## Command Reference

### deai.py (Python Version)

bash scripts/deai.sh input.png output.jpg heavy

-bash-scriptsdeaish-inputpng-outputjpg-heavy.txt
---

## Understanding Detection

### Common AI Detectors

| Detector | Method | Bypass Rate |
|----------|--------|-------------|
| **Hive Moderation** | Deep learning model | 50-70% (medium) |
| **Illuminarty** | Computer vision analysis | 60-75% (medium) |
| **AI or Not** | Binary classification | 55-70% (medium) |
| **SynthID** | Pixel-level watermark | 35-50% (heavy) |
| **C2PA Verify** | Metadata check | 100% (metadata strip) |

### What This Skill Cannot Do

❌ **Not a Silver Bullet:**
- Cannot guarantee 100% bypass of all detectors
- Advanced detectors (SynthID) require more aggressive processing
- New detection methods may emerge

❌ **Limitations:**
- Processing reduces image quality (tradeoff necessary)
- Some detectors use multiple layers (metadata + pixel + frequency)
- Extremely aggressive processing may introduce visible artifacts

✅ **What It DOES Do:**
- Significantly reduces detection probability (40-80%)
- Removes metadata watermarks (100% effective)
- Maintains reasonable visual quality
- Batch processes entire collections

---

## Verification Workflow

1. **Process Image:**

exiftool -all= step1_edited.jpg

exiftool--all-step1editedjpg.txt
---

## Best Practices

### For Social Media
- Use `medium` strength (good balance)
- Output as JPEG (universal compatibility)
- Test on platform's upload flow before posting

### For Professional Use
- Start with `light` (preserve quality)
- Manual review each output
- Keep originals in secure storage
- Document processing steps

### For Research/Testing
- Use `heavy` for stress testing
- Compare multiple detectors
- Document success/failure patterns

---

## Legal & Ethical Notice

⚠️ **Use Responsibly:**

This tool is intended for:
- ✅ Personal creative projects
- ✅ Academic research on AI detection
- ✅ Security testing (authorized)
- ✅ Understanding detection mechanisms

**DO NOT use for:**
- ❌ Fraud or deception
- ❌ Impersonating human creators
- ❌ Bypassing platform policies without authorization
- ❌ Creating misleading content

**Legal Risks:**
- Some jurisdictions (e.g., COPIED Act 2024) may restrict watermark removal
- Platform terms of service often prohibit AI content masking
- Commercial use may have additional legal requirements

**You are responsible for compliance with applicable laws and terms of service.**

---

## Troubleshooting

### "Command not found: exiftool"

python scripts/deai.py input.png --strength light

python-scriptsdeaipy-inputpng---strength-light.txt
---

## Development

### Running Tests
example.sh
# Basic processing (medium strength)
python scripts/deai.py input.png

# Specify output file
python scripts/deai.py input.png -o output.jpg

# Adjust processing strength
python scripts/deai.py input.png --strength heavy

# Only strip metadata (fastest)
python scripts/deai.py input.png --no-metadata

# Batch process directory
python scripts/deai.py input_dir/ --batch

# Pure Bash version (no Python needed)
bash scripts/deai.sh input.png output.jpg
example.sh
# Default medium strength
python scripts/deai.py ai_portrait.png

# Light processing for high-quality images
python scripts/deai.py artwork.png --strength light -o clean_artwork.jpg

# Heavy processing for stubborn detection
python scripts/deai.py midjourney_out.png --strength heavy

Tags

#git_and-github

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author swaylq
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install deai-image