Analyze an image's visual composition using mathematical features.

This extracts statistical properties (color distribution, texture patterns, edge orientations) that describe HOW an image looks, not WHAT it contains.

Args: image_path: Path to the image file (jpg, png, webp, etc.) preset: Analysis depth - one of: - "quick": Color histogram + edges (144 dims, fast) - "color": Detailed color analysis (605 dims) - "color_advanced": Fuzzy, scalable, correlogram features - "texture": LBP, Tamura, Haralick, Gabor (328 dims) - "texture_advanced": Rotation-invariant LBP, Centrist - "shape": Edge histogram, HOG, Hu moments (231 dims) - "shape_advanced": PHOG pyramid (630 dims) - "layout": Spatial color/luminance layout (76 dims) - "combined": CEDD, FCTH, JCD - best for similarity (504 dims) - "full": All 22 features (3058 dims, comprehensive)

Returns: Human-readable analysis with feature interpretations.

Compare two images mathematically to get a similarity score.

This measures visual similarity based on mathematical features, NOT semantic content. Different subjects can be "similar" if they share color palettes, textures, or compositions.

Args: image_a: Path to first image image_b: Path to second image feature: Feature for comparison. Recommended: - "CEDD": Color + edge (144 dims, good general purpose) - "JCD": Joint CEDD+FCTH (168 dims, best for similarity) - "ColorHistogram": Color only (64 dims) - "LocalBinaryPatterns": Texture only (256 dims) - "PHOG": Shape only (630 dims) metric: Distance metric - "cosine", "euclidean", "l1"

Returns: Similarity score (0-100%) and interpretation.

Find visually similar images in a folder.

Scans all images and ranks them by visual similarity to the query. Similarity is based on mathematical features, not semantic content.

Args: query_image: Path to the reference image folder_path: Folder to search top_k: Number of results (1-20) feature: Feature for comparison - "JCD", "CEDD", "ColorHistogram", etc.

Returns: Ranked list of similar images with scores.

Extract the dominant colors from an image.

Uses K-means clustering to find the most prominent colors. Returns exact hex codes and percentages.

Args: image_path: Path to the image num_colors: Number of colors to return (1-5)

Returns: List of hex codes with percentages.

Analyze image quality: blur, contrast, texture complexity.

Uses texture analysis to detect blur and quality issues. More reliable than asking an LLM to visually judge blur.

Args: image_path: Path to the image

Returns: Quality assessment with specific metrics.

Sort all images in a folder by their dominant hue.

Returns images ordered: grayscale → warm (red/orange/yellow) → green → cool (blue/cyan) → purple → back to red.

Useful for creating color-organized galleries.

Args: folder_path: Folder containing images

Returns: Ordered list of images with dominant hue values.

Filter images by visual "vibe" categories.

Uses color and texture features to categorize images into semantic groups based on their mathematical properties.

Args: folder_path: Folder to search vibe: Category to filter by: - "blue_water": Blue dominant, water/sky scenes - "green_nature": Green dominant, nature scenes - "warm_sunset": Orange/red/yellow tones - "cool_moody": Blue/purple, low saturation - "high_contrast": Strong texture, high contrast - "soft_minimal": Low texture, smooth gradients - "grayscale": Black and white or desaturated - "vibrant": High saturation, colorful

Returns: List of matching images with confidence scores.

Extract raw feature vectors from an image.

Returns numerical vectors for custom ML pipelines, database indexing, or advanced analysis.

Args: image_path: Path to the image features: Comma-separated feature names. Available (22 total): Color: ColorHistogram, ColorMoments, OpponentHistogram, FuzzyColorHistogram, DominantColors, ScalableColor Texture: LocalBinaryPatterns, RotationInvariantLBP, Gabor, Tamura, Haralick, Centrist Shape: EdgeHistogram, PHOG, HOG, HuMoments Layout: ColorLayout, LuminanceLayout Combined: CEDD, FCTH, JCD, AutoColorCorrelogram

Returns: JSON with feature vectors and statistics.

List all available features from the imagefeatures library.

Returns documentation for all 22 feature extractors with dimensions and recommended use cases.