88 lines
2.9 KiB
Markdown
88 lines
2.9 KiB
Markdown
# Using IIB with AI Agents (Claude Code, Cursor, OpenClaw, etc.)
|
|
|
|
IIB can be used as an [Agent Skill](https://agentskills.io), allowing AI agents to search, browse, tag, and organize your images through natural language.
|
|
|
|
## Installation
|
|
|
|
Install the IIB skill for your AI agent:
|
|
|
|
```bash
|
|
npx skills add https://github.com/zanllp/infinite-image-browsing --skill iib
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Step 1: Start IIB Service
|
|
|
|
First, start the IIB service:
|
|
|
|
```bash
|
|
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](https://agentskills.io) 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
|