sd-webui-infinite-image-bro.../docs/ai-agents.md

2.9 KiB

Using IIB with AI Agents (Claude Code, Cursor, OpenClaw, etc.)

IIB can be used as an Agent Skill, allowing AI agents to search, browse, tag, and organize your images through natural language.

Installation

Install the IIB skill for your AI agent:

npx skills add https://github.com/zanllp/infinite-image-browsing --skill iib

Usage

Step 1: Start IIB Service

First, start the IIB service:

python app.py --port <port>

Step 2: Interact with Your AI Agent

Once IIB is running, you can ask your AI agent to help with various image tasks:

Search & Filter:

  • "Find all images with 'sunset' in the prompt"
  • "Show me images generated with model X"
  • "Find images tagged as 'favorites'"
  • "Find images with people but exclude drafts"
  • "Search for high quality landscape images"

Tag Management:

  • "Tag these images as 'best quality'"
  • "Remove the 'test' tag from all images"
  • "Add the 'portrait' tag to images with people"

File Organization:

  • "Organize my Downloads folder by theme"
  • "Move all landscape images to a separate folder"
  • "Create folders for different art styles"

Information Retrieval:

  • "Show me the generation parameters of this image"
  • "What prompts were used for these images?"
  • "Compare the settings between these two images"

Available View Types

View Type Description URL Example
Quick View Fullscreen preview of single image ?action=view&path=/path/to/img.png
Keyword Search Search page for keyword filtering ?action=pane&type=fuzzy-search
Keyword Search (Pre-filled) Search with auto-filled keyword ?action=pane&type=fuzzy-search&props={"substr":"sunset"}
Tag Search Filter by tags ?action=pane&type=tag-search
Tag Results Pre-filtered tag search results ?action=pane&type=tag-search-matched-image-grid&props=...
Image Compare Side-by-side comparison ?action=pane&type=img-sli&props=...
Folder Browse Browse specific folder ?action=pane&type=local&props=...
Random Images Display random images ?action=pane&type=random-image

Example prompts:

  • "Search for images with 'sunset' in the prompt"
  • "Show all images tagged as favorites"
  • "Compare these two images in IIB"

Supported AI Agents

IIB's skill is compatible with:

  • Claude Code - Anthropic's official CLI for Claude
  • Cursor - AI code editor
  • OpenClaw - AI coding assistant
  • Any other agent that supports the Agent Skills format

Requirements

  • Python 3.7+
  • IIB service running on an accessible port
  • AI agent with Agent Skills support

Troubleshooting

If the agent cannot connect to IIB:

  1. Ensure IIB service is running (python app.py --port <port>)
  2. Check that the port matches the one configured in your agent
  3. Verify network/firewall settings allow local connections