2.9 KiB
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:
- Ensure IIB service is running (
python app.py --port <port>) - Check that the port matches the one configured in your agent
- Verify network/firewall settings allow local connections