cakelens-v5

Open-source AI-gen video detection model

Installation

Install the package with its dependencies:

pip install cakelens-v5

Command Line Interface

The package provides a command line tool cakelens for easy video detection:

Basic Usage

# Using Hugging Face Hub (recommended)
cakelens video.mp4

# Using local model file
cakelens video.mp4 --model-path model.pt

Options

• --model-path: Path to the model checkpoint file (optional - will load from Hugging Face Hub if not provided)
• --batch-size: Batch size for inference (default: 1)
• --device: Device to run inference on (cpu, cuda, mps) - auto-detected if not specified
• --verbose, -v: Enable verbose logging
• --output: Output file path for results (JSON format)

Examples

# Basic detection (uses Hugging Face Hub)
cakelens video.mp4

# Using local model file
cakelens video.mp4 --model-path model.pt

# With custom batch size and device
cakelens video.mp4 --batch-size 4 --device cuda

# Save results to JSON file
cakelens video.mp4 --output results.json

# Verbose output
cakelens video.mp4 --verbose

Output

The tool provides:

• Real-time prediction percentages for each label
• Final mean predictions across all frames
• Option to save results in JSON format
• Detailed logging (with --verbose flag)