🎨 Majoor Assets Manager

🚀 Quick Start

📦 Installation

Method A: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager in your browser
2. Search for "Majoor Assets Manager"
3. Click Install, then restart ComfyUI completely
4. The extension appears in the sidebar as a folder icon 📁

Method B: Manual Installation

# Navigate to ComfyUI custom_nodes directory
cd ComfyUI/custom_nodes

# Clone the repository
git clone https://github.com/MajoorWaldi/ComfyUI-Majoor-AssetsManager ComfyUI-Majoor-AssetsManager

# Install Python dependencies
cd ComfyUI-Majoor-AssetsManager
pip install -r requirements.txt

# Optional: install AI/vector features
# pip install -r requirements.txt -r requirements-vector.txt

# Restart ComfyUI

Optional Dependencies (Recommended)

For full metadata extraction, install these tools:

Windows (PowerShell)

# Using Scoop
scoop install ffmpeg exiftool

# OR using Chocolatey
choco install -y ffmpeg exiftool

# OR using WinGet
winget install -e --id Gyan.FFmpeg
winget install -e --id OliverBetz.ExifTool

macOS

brew install ffmpeg exiftool

Linux

# Ubuntu/Debian
sudo apt update
sudo apt install -y ffmpeg libimage-exiftool-perl

# Fedora/RHEL
sudo dnf install -y ffmpeg perl-Image-ExifTool

📖 Basic Usage

First Steps

1. Open Assets Manager: Click the folder icon 📁 in ComfyUI sidebar
2. Choose Scope: Select Outputs, Inputs, Custom, or Collections
3. Browse Assets: Scroll through the grid view with virtual scrolling
4. Search: Type in the search bar for full-text search
5. Filter: Use dropdowns for kind, rating, workflow, date filters

Asset Operations (Right-Click Menu)

Collections

1. Select assets (Ctrl/Cmd+click for multiple)
2. Right-click → Add to Collection
3. Create new or add to existing collection
4. Access via Collections scope

🤖 AI Features NEW!

What AI Features Are Available

AI Models Used

How to Enable AI Features

1. Open Settings in Assets Manager
2. Ensure Enable AI semantic search is toggled ON (default: ON)
3. Trigger initial index scan (Ctrl+S)
4. Click Backfill vectors in Index Status section
5. Wait for embeddings to be computed (5-30 min for 1000 assets)

Using AI Features

Semantic Search

1. Click the sparkles icon (🔮) in the search bar
2. Type natural language: "cyberpunk city at night with neon lights"
3. Press Enter to see results ranked by relevance

Find Similar

1. Select an asset in the grid
2. Right-click → Find Similar
3. Browse visually similar assets

Generate Caption

1. Open an asset in the Viewer
2. In sidebar, find Image Description section
3. Click Generate
4. Wait for AI caption (5-30 seconds)

Per-Asset Operations (Quick Actions)

You can trigger scan and backfill vectors for individual assets directly from the grid:

Via Card Status Dot

1. Click the status dot on an asset card (corner indicator)
2. Select from the menu:
   • "Index Asset" — Trigger metadata scan for this asset
   • "Generate Vector" — Compute AI embedding
   • "Re-index" — Force re-scan and re-compute vectors

Via Sparkles Icon (🔮) on Card

1. Hover over an asset card to reveal action buttons
2. Click the sparkles icon (🔮) if visible
3. Choose AI actions:
   • Generate Caption — Run Florence-2 captioning
   • Compute Alignment — Calculate prompt alignment score
   • Suggest Tags — Generate AI auto-tags
   • Find Similar — Show visually similar assets

Visual Status Indicators

Performance Expectations

Configuration

# Enable/disable AI features (default: ON)
export MJR_AM_ENABLE_VECTOR_SEARCH=1

# Adjust auto-tag sensitivity (0.0-1.0, default: 0.25)
export MJR_AM_VECTOR_AUTOTAG_THRESHOLD=0.25

# Verbose AI logging for debugging
export MJR_AM_AI_VERBOSE_LOGS=1

🖼️ Advanced Viewer

Opening the Viewer

• Double-click any asset in the grid
• Or right-click → Open in Viewer
• Or press Enter on selected asset

Viewer Features

Navigation

• Mouse Wheel: Zoom in/out
• Click + Drag: Pan zoomed image
• Left/Right Arrow: Previous/Next asset
• Esc: Close viewer
• F: Toggle fullscreen

📋 Organization: Ratings, Tags & Collections

Ratings System

• 0-5 Stars: Rate assets by quality or preference
• Windows Sync: Ratings sync with Windows Explorer (RatingPercent)
• Filter by Rating: Show only 4+ star assets, etc.
• Keyboard: Press 0-5 to rate selected asset

Tags System

• Custom Tags: Add any tags you want
• Hierarchical: Use colons for hierarchy (style:anime:fantasy)
• Autocomplete: Tags suggest as you type
• Bulk Operations: Apply tags to multiple assets

Collections

• Save Selections: Group assets across scopes
• Smart Collections: AI-suggested groupings
• Discover Groups: Auto-cluster by visual similarity
• Persistent: Collections saved to disk

⌨️ Keyboard Shortcuts

Global / Panel

Grid View

Viewer

🔧 Troubleshooting

Extension Not Appearing

• Verify installation in custom_nodes/ComfyUI-Majoor-AssetsManager
• Check ComfyUI console for import errors
• Ensure core dependencies: pip install -r requirements.txt
• If you use AI/vector features, also install: pip install -r requirements.txt -r requirements-vector.txt
• Restart ComfyUI completely

Database Corruption

1. Open Assets Manager → Index Status section
2. Click Delete DB button
3. Confirm the warning dialog
4. Database rebuilds automatically

External Tools Not Found

# Verify installation
exiftool -ver
ffprobe -version

# If not found, install:
# Windows: scoop install ffmpeg exiftool
# macOS: brew install ffmpeg exiftool
# Linux: sudo apt install ffmpeg libimage-exiftool-perl

AI Features Not Working

• Check if AI is enabled in Settings
• Verify models downloaded (check console logs)
• Run Backfill vectors in Index Status
• Ensure sufficient RAM (8GB minimum, 16GB recommended)

Slow Performance

• Reduce page size in settings (default: 50-100)
• Exclude very large directories from custom roots
• Ensure SSD storage for database
• For AI: enable GPU acceleration if available

📚 Additional Resources

Documentation

• 📑 Documentation Index
• 🔐 Privacy / Offline Guide
• 🤖 AI Features Guide
• 🔧 API Reference
• 📦 Installation Guide
• ⚙️ Settings & Configuration
• 🗄️ Database Maintenance
• 🖼️ Viewer Tutorial
• ⌨️ Hotkeys & Shortcuts

Community

• GitHub Repository
• Report Issues
• Discussions
• ☕ Support the Developer