sd-webui-infinite-image-browsing
A full-featured image/video management app with AI-powered organization and semantic search. Supports metadata from SD-webui, ComfyUI, Fooocus, NovelAI, StableSwarmUI, and more. Available as standalone app, SD-webui extension, or library.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/zanllp/infinite-image-browsing with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/zanllp/infinite-image-browsing'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/zanllp--sd-webui-infinite-image-browsing)HTML
<a href="/listings/zanllp--sd-webui-infinite-image-browsing"><img src="/api/listings/zanllp--sd-webui-infinite-image-browsing/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
As an extension for SD-webui:
1. Open the `Extensions` tab in SD-webui. 2. Select the `Install from URL` option. 3. Enter `https://github.com/zanllp/sd-webui-infinite-image-browsing`. 4. Click on the `Install` button. 5. Wait for the installation to complete and click on `Apply and restart UI`.
As a standalone program that runs using Python. (without SD-webui):
Refer to [Can the extension function without the web UI?](https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/47)
If you need to view images generated by ComfyUI/Fooocus/NovelAI, please refer to [https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/202](https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/202#issuecomment-1655764627).
If you need a Dockerfile, you can refer to this link. https://github.com/zanllp/sd-webui-infinite-image-browsing/discussions/366
As a desktop application (without SD-webui and Python):
The executable version also supports ComfyUI/Fooocus/NovelAI.
Download and install the program from the [`releases`](https://github.com/zanllp/infinite-image-browsing/releases) section on the right-hand side of the repository page. If the antivirus detects a virus, it can be ignored as a false positive. There are two versions of the compiled version for Windows, with the pyinstaller version having a lower false positive rate.
If you need to compile it yourself, please refer to https://github.com/zanllp/sd-webui-infinite-image-browsing/blob/main/.github/workflows/tauri_app_build.yml.
As a Library Usage:
Use iframe to access IIB and use it as a file browser for your application. Refer to https://github.com/zanllp/sd-webui-infinite-image-browsing/blob/main/vue/usage.md
As an AI Agent Skill
IIB can be used with AI agents like Claude Code, Cursor, and OpenClaw. See [AI Agents Documentation](docs/ai-agents.md) for details.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 337 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- > ✨ **New from the same author**: [SpindleStudio](https://github.com/zanllp/SpindleStudio) — a Threads-style parallel image generation studio. Its images carry SD WebUI–compatible metadata and are indexed by IIB out of the box.
- [中文文档](./README-zh.md)
- [Change log](./CHANGELOG.md)
- [Installation / Running](#installation--running)
- # Infinite Image Browsing (IIB)
- ### Software Support and Development Progress Overview
- | Software | Support | Provided by |
- | ---------------------- | ---------------- | ----------- |
- | Stable Diffusion web UI| Supported | Built-in |
- | Stable Diffusion web UI (Stealth)| Supported ([default: disabled](https://github.com/zanllp/sd-webui-infinite-image-browsing/blob/main/.env.example#L49)) | Built-in |
- | ComfyUI | Partially supported | Built-in |
- | Fooocus | Supported | Built-in |
- | NovelAI | Supported | Built-in |
- | StableSwarmUI | Supported | Built-in |
- | Invoke.AI | Supported | Built-in |
- | Pixiv | Supported | [pixiv_iib_plugin](https://github.com/zanllp/pixiv_iib_plugin) |
- If you would like to support more software, please refer to: [parsers](https://github.com/zanllp/sd-webui-infinite-image-browsing/tree/main/scripts/iib/parsers) or [pixiv_iib_plugin](https://github.com/zanllp/pixiv_iib_plugin)
- ## Key Features
- ### 🔥 Excellent Performance
- - Once caching is generated, images can be displayed in just a few milliseconds.
- - Images are displayed with thumbnails by default, with a default size of 512 pixels. You can adjust the thumbnail resolution on the global settings page.
- - You can also control the width of the grid images, allowing them to be displayed in widths ranging from 64px to 1024px.
- - Supports pre-generating thumbnails and video covers to improve performance using `--generate_video_cover` and `--generate_image_cache`.
- - Supports specifying the cache directory through the `IIB_CACHE_DIR` environment variable.
- ### 🔍 Image Search & Favorite
- - The prompt, model, Lora, and other information will be converted into tags and sorted by frequency of use for precise searching.
- - Supports tag autocomplete, [auto-translation](https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/39), and customization.
- - Image favorite can be achieved by toggling custom tags for images in the right-click menu.
- - Support for advanced search similar to Google
- - Also supports fuzzy search, you can search by a part of the filename or generated information.
- - Support adding custom search paths for easy management of folders created by the user.
- - Media type filtering, video tag search, and random sort.
- - Auto-tagging with custom rules.
- ### 🖼️ View Images/Videos & `Send To`
- - Supports viewing image generation information. Also supported in full-screen preview mode.
- - EXIF/metadata is integrated in full-screen preview with nested JSON navigation and highlighting.
- - Supports sending images to other tabs and third-party extensions such as ControlNet , openOutpaint.
- - Support full-screen preview and enable custom shortcut key operations while in full-screen preview mode.
- - Support navigating to the previous or next image in full-screen preview mode by pressing arrow keys or clicking buttons.
- - Support playing video files from a remote server.
- ### 💻 Multiple Usage Methods
- - You can install it as an extension on SD-webui.
- - You can run it independently using Python.
- - The desktop app version is also available.
- - Supports multiple popular AI software.
- - **NEW**: [Use with AI agents](docs/ai-agents.md) (Claude Code, Cursor, OpenClaw, etc.)
- ### 📊 Trend & Statistics
- - GitHub-style contribution heatmap showing daily image generation activity.
- - Monthly trend bar chart, top models, and top source distribution.
- - Total image count and disk usage at a glance.
- - Click the 📊 icon on the startup page or find "Trend" under Launch.
- ### 🎵 TikTok-Style View
- - TikTok-style vertical browsing for images and videos.
- - Polished info panel with backdrop/preview return improvements.
- - Delete events stay in sync across the TikTok view.
- ### 🚶♀️ Walk Mode
- - Automatically load the next folder `(similar to os.walk)`, allowing you to browse all images without paging.
- - Tested to work properly with over 27,000 files.
- - When there are folders, you can switch to walk mode from other modes by clicking the walk button in the upper right corner. It will flatten all the folders, avoiding the tedious operation of going in and out of folders.
- ### 🌳 Preview based on File Tree Structure & File operations
- - Supports file tree-based preview.
- - Supports automatic refreshing.
- - Supports basic file operations, such as multiple selection for deleting/moving/copying, and creating new folders.
- - Hold down the Ctrl, Shift, or Cmd key to select multiple items.
- - Supported multi-select operations include: delete, move, copy, pack download, add tags, remove tags, move to another folder, copy to another folder, drag and drop.
- - You can keep the multi-select state by clicking the "Keep Multi-Select" button in the lower right corner, allowing you to perform multiple operations on the selected file collection conveniently.
- - Drag-and-drop into folders and safer move/copy (continue on error).
- ### 🆚 image comparison (similar to Imgsli)
- - Provides a side-by-side comparison of two images.
- - Provides a comparison of image generation information at the same time.
- ### 🧠 Topic/Tag Analysis
- - Tag relationship graph visualization for topic clusters.
- ### 🗂️ Smart Organize
- AI-powered automatic file organization
- - **Semantic Clustering**: Automatically groups similar images based on prompt semantics using AI embeddings
- - **Auto-Generated Folder Names**: AI generates meaningful folder names in your preferred language
- - **Preview Before Action**: Review the proposed organization before confirming - skip or adjust as needed
- - **Background Processing**: Large folders are processed in the background, you can continue working
- - **Flexible Options**: Choose between move or copy, set minimum cluster size, include subfolders recursively
- > **Requirements**: Same as Topic Search - requires `OPENAI_BASE_URL`, `OPENAI_API_KEY`, and Python dependencies `numpy`, `hnswlib`
- >
- > 📸 See [Smart Organize Preview](#smart-organize) below for screenshots and video demo.
- ### 🌐 Multilingual Support
- - Currently supports Simplified Chinese/Traditional Chinese/English/German.
- - If you would like to add a new language, please refer to [i18n.ts](https://github.com/zanllp/sd-webui-infinite-image-browsing/blob/main/vue/src/i18n/zh-hans.ts) and submit the relevant code.
- ### 🔐 Privacy and Security
- - Supports custom secret key for authentication.
- - Supports configuring access control for the file system, which will be enabled by default when the service allows public access (Only when used as an extension of sd-webui).
- - Supports customizing the allowed paths for access control.
- - Supports controlling access permissions. You can run IIB in read-only mode.
- - [Click here to see details](.env.example)
- ### 📦 Packaging/Batch Download
- - Allows you to download multiple images at once.
- - The data source can be search results, a regular image grid view page, walk mode, etc. Images can be added to the processing list through drag-and-drop or "Send To".
- ### ⌨️ Keyboard Shortcuts
- - Allows for deleting and adding/removing tags, with customizable trigger buttons in the global settings page.
- If you like this project and find it helpful, please consider giving it a ⭐️. This would be very important for me to continue developing and maintaining this project. If you have any suggestions or ideas, please feel free to raise them in the issue section, and I will respond as soon as possible. Thank you again for your support!
- <a href='https://ko-fi.com/zanllp' target='_blank'><img height='35' style='border:0px;height:46px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='Buy Me a Coffee at ko-fi.com' />
- [Sponsor me on WeChat](.github/wechat_funding.jpg)
- # Installation / Running
- ## As an extension for SD-webui:
- 1. Open the `Extensions` tab in SD-webui.
- 2. Select the `Install from URL` option.
- 3. Enter `https://github.com/zanllp/sd-webui-infinite-image-browsing`.
- 4. Click on the `Install` button.
- 5. Wait for the installation to complete and click on `Apply and restart UI`.
- ## As a standalone program that runs using Python. (without SD-webui):
- Refer to [Can the extension function without the web UI?](https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/47)
- If you need to view images generated by ComfyUI/Fooocus/NovelAI, please refer to [https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/202](https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/202#issuecomment-1655764627).
- If you need a Dockerfile, you can refer to this link. https://github.com/zanllp/sd-webui-infinite-image-browsing/discussions/366
- ## As a desktop application (without SD-webui and Python):
- The executable version also supports ComfyUI/Fooocus/NovelAI.
- Download and install the program from the [`releases`](https://github.com/zanllp/infinite-image-browsing/releases) section on the right-hand side of the repository page.
- If the antivirus detects a virus, it can be ignored as a false positive. There are two versions of the compiled version for Windows, with the pyinstaller version having a lower false positive rate.
- ### macOS (unsigned preview)
- Choose the `aarch64-unsigned.dmg` download for Apple Silicon (M-series), or `x64-unsigned.dmg` for Intel. macOS 14 or later is required. Drag **Infinite Image Browsing** into Applications before opening it; do not run it directly from the disk image.
- These builds have no Apple Developer ID signature and are not notarized. If macOS blocks the app, review [Apple's instructions for opening an unnotarized app](https://support.apple.com/en-us/102445). Only allow it if you trust the download from this repository. Do not disable Gatekeeper system-wide. An ad-hoc signature protects the integrity of bundled code, but does not make Apple trust the app.
- If the trusted official download still will not start, the following command removes the download quarantine flag from **this app only**, including its bundled backend:
- ```sh
- xattr -dr com.apple.quarantine "/Applications/Infinite Image Browsing.app"
- ```
- This is an explicit per-app exception, not Apple verification. Do not run it on your Downloads folder or an entire disk. Both macOS architectures have been tested with this exception; the original quarantined downloads are still blocked by Gatekeeper.
- The app starts a bundled Python backend. If the window opens but the backend does not start, allowing the main app alone may not have resolved the problem. Check `iib_api_server.log` in `~/Library/Application Support/com.zanllp.iib/` and include the relevant error when reporting an issue. The database, backups, `.env`, and optional `app.conf.json` also live in this directory, not inside the app bundle. Access to protected folders is controlled separately in **System Settings > Privacy & Security > Files and Folders**.
- If you need to compile it yourself, please refer to https://github.com/zanllp/sd-webui-infinite-image-browsing/blob/main/.github/workflows/tauri_app_build.yml.
- ## As a Library Usage:
- Use iframe to access IIB and use it as a file browser for your application. Refer to https://github.com/zanllp/sd-webui-infinite-image-browsing/blob/main/vue/usage.md
- ## As an AI Agent Skill
- IIB can be used with AI agents like Claude Code, Cursor, and OpenClaw. See [AI Agents Documentation](docs/ai-agents.md) for details.
- # Preview
- <img width="1920" alt="image" src="https://user-images.githubusercontent.com/25872019/232167682-67f83b00-4391-4394-a7f6-6e4c9d11f252.png">
- ## Image Search
- During the first use, you need to click and wait for the index generation. For my case with 20,000 images, it took about 45 seconds (with an AMD 5600X CPU and PCIe SSD). For subsequent uses, it will check whether there are changes in the folder, and if so, it needs to regenerate the index. Usually, this process is very fast.
- Image search supports translation, see https://github.com/zanllp/sd-webui-infinite-image-browsing/issues/39 for more detail. Feel free to share files for other languages to facilitate everyone's use.
- <img width="1109" alt="image" src="https://github.com/zanllp/sd-webui-infinite-image-browsing/assets/25872019/62d1ffe3-2d1f-4449-803a-970273753855">
- <img width="620" alt="image" src="https://user-images.githubusercontent.com/25872019/234639759-2d270fe5-b24b-4542-b75a-a025ba78ec89.png">
- ## Full Screen Preview (Side-by-Side Layout)
- 
- ## Full Screen Preview
- <img width="1024" alt="image" src="https://user-images.githubusercontent.com/25872019/232167416-32a8b19d-b766-4f98-88f6-a1d48eaebec0.png">
- In full-screen preview mode, you can also view image information and perform operations on the context menu. It supports dragging, resizing and expanding/collapsing .
- https://user-images.githubusercontent.com/25872019/235327735-bfb50ea7-7682-4e50-b303-38159456e527.mp4
- If you, like me, don't need to view the generation information, you can choose to simply minimize this panel, and all contextual operations will still be available.
- <img width="599" alt="image" src="https://github.com/zanllp/sd-webui-infinite-image-browsing/assets/25872019/f26abe8c-7a76-45c3-9d7f-18ae8b6b6a91">
- ## Image comparison
- 
- ## Transfer files between different tab panes.
- https://github.com/zanllp/sd-webui-infinite-image-browsing/assets/25872019/e631e3c3-1cbf-49bc-8577-f2963a6c9e4d
- ### Right-click menu
- <img width="536" alt="image" src="https://user-images.githubusercontent.com/25872019/232162244-e728d510-b6c6-45e6-afb3-872bd67db05b.png">
- You can also trigger it by hovering your mouse over the icon in the top right corner.
- <img width="227" alt="image" src="https://github.com/zanllp/sd-webui-infinite-image-browsing/assets/25872019/f2005ad3-2d3b-4fa7-b3e5-bc17f26f7e19">
- ### Walk mode
- https://user-images.githubusercontent.com/25872019/230768207-daab786b-d4ab-489f-ba6a-e9656bd530b8.mp4
- ### Dark mode
- <img width="768" alt="image" src="https://user-images.githubusercontent.com/25872019/230064879-c95866ac-999d-4d4b-87ea-3e38c8479415.png">
- ## Smart Organize
- AI-powered automatic file organization - groups similar images and creates meaningful folders.
- <img width="500" alt="Smart Organize Config Modal" src="docs/imgs/smart-organize-config-modal.png" />
- <img width="500" alt="Smart Organize Generate Title" src="docs/imgs/smart-organize-generate-title.png" />
- <img width="800" alt="Smart Organize Preview" src="docs/imgs/smart-organize-preview.png" />
- <img width="800" alt="Smart Organize Preview List" src="docs/imgs/smart-organize-preview-list.png" />
- https://github.com/user-attachments/assets/c1279556-d255-4e71-b230-48523a4859bf
- ## Natural Language Categorization & Search (Experimental)
- This feature groups images by **semantic similarity of prompts** and supports **natural-language retrieval** (similar to the retrieval stage in RAG).
- It’s experimental: results depend on the embedding/chat models and the quality of prompt metadata.
- ### How to Use (for end users)
- 1. Open **“Natural Language Categorization & Search (Experimental)”** from the startup page
- 2. Click **Scope** and select one or more folders (from QuickMovePaths)
- 3. **Categorize**: click **Refresh** to generate topic cards for the selected scope
- 4. **Search**: type a natural-language query and click **Search** (auto-opens the result grid)
- > The selected scope is persisted in backend KV: `app_fe_setting["topic_search_scope"]`. Next time it will auto-restore and auto-refresh once.
- ### API Endpoints
- - **Build/refresh embeddings**: `POST /infinite_image_browsing/db/build_iib_output_embeddings`
- - Request: `folder`, `model`, `force`, `batch_size`, `max_chars`
- - **Cluster (categorize)**: `POST /infinite_image_browsing/db/cluster_iib_output_job_start` then poll `GET /infinite_image_browsing/db/cluster_iib_output_job_status?job_id=...`
- - Request: `folder_paths` (required, array), `threshold`, `min_cluster_size`, `force_embed`, `title_model`, `force_title`, `use_title_cache`, `assign_noise_threshold`, `lang`
- - **Prompt retrieval (RAG-like)**: `POST /infinite_image_browsing/db/search_iib_output_by_prompt`
- - Request: `query`, `folder_paths` (required, array), `top_k`, `min_score`, `ensure_embed`, `model`, `max_chars`
- ### How it Works (simple explanation)
- - **1) Prompt extraction & normalization**
- - Reads `image.exif` and keeps content before `Negative prompt:`
- - Optionally removes “boilerplate” terms (quality/photography parameters, etc.) to focus on topic semantics (`IIB_PROMPT_NORMALIZE*`)
- - **2) Embeddings**
- - Calls OpenAI-compatible `/embeddings`
- - Stores vectors in SQLite table `image_embedding` (incremental, to avoid repeated costs)
- - **3) Clustering**
- - Online centroid-sum clustering, plus a post-merge step for highly similar clusters
- - Optionally reassigns members of small clusters into the closest large cluster to reduce noise
- - **4) Title generation (LLM)**
- - Calls `/chat/completions` with tool/function calling to force structured JSON output
- - Stores titles/keywords in SQLite table `topic_title_cache`
- - **5) Retrieval**
- - Embeds the query and ranks images in the selected scope by cosine similarity, returning TopK
- ### Caching & Incremental Updates
- #### 1) Embedding cache (`image_embedding`)
- - **Where**: table `image_embedding` (keyed by `image_id`)
- - **Skip rule (incremental update)**: an image is skipped if:
- - same `model`
- - same `text_hash`
- - existing `vec` is present
- - **Re-vectorization cache key**: `text_hash = sha256(f"{normalize_version}:{prompt_text}")`
- - `prompt_text` is the extracted + (optionally) normalized text used for embeddings
- - `normalize_version` is a **code-derived fingerprint** of normalization rules/mode (not user-configurable)
- - **Force rebuild**: pass `force=true` to `build_iib_output_embeddings` or `force_embed=true` to `cluster_iib_output_job_start`
- #### 2) Title cache (`topic_title_cache`)
- - **Where**: table `topic_title_cache` keyed by `cluster_hash`
- - **Hit rule**: when `use_title_cache=true` and `force_title=false`, titles/keywords are reused
- - **Cache key (`cluster_hash`) includes**:
- - member image IDs (sorted)
- - embedding `model`, `threshold`, `min_cluster_size`
- - `title_model`, output `lang`
- - normalization fingerprint (`normalize_version`) and mode
- - **Force title regeneration**: `force_title=true`
- ### Configuration (Environment Variables)
- All calls use an **OpenAI-compatible** provider:
- - **`OPENAI_BASE_URL`**: e.g. `https://your-host/v1`
- - **`OPENAI_API_KEY`**: your API key
- - **`EMBEDDING_MODEL`**: embeddings model used for clustering and semantic search
- - **`AI_MODEL`**: default chat model (fallback)
- - **`TOPIC_TITLE_MODEL`**: chat model used for cluster titles (falls back to `AI_MODEL`)
- - **`IIB_PROMPT_NORMALIZE`**: `1/0` enable prompt normalization
- - **`IIB_PROMPT_NORMALIZE_MODE`**: `balanced` (recommended) / `theme_only`
- ##### Optional: TwelveLabs Marengo embedding backend
- Embeddings normally go to an OpenAI-compatible `/embeddings` endpoint. As an opt-in
- alternative you can embed prompt text with [TwelveLabs](https://twelvelabs.io) Marengo,
- which embeds text/image/audio/video into one shared latent space:
- - Set **`EMBEDDING_MODEL=marengo3.0`**.
- - Set **`TWELVELABS_API_KEY`** to your TwelveLabs key (falls back to `OPENAI_API_KEY` if
- unset, for backward compatibility). `OPENAI_BASE_URL` is ignored for embeddings, and the
- OpenAI-compatible chat path used for cluster titles is unaffected.
- - Install the optional dependency: `pip install 'twelvelabs>=1.2.8'`.
- This is fully opt-in and non-breaking — the default OpenAI-compatible path is unchanged
- unless you select a Marengo model. You can grab a free API key (generous free tier) at
- <https://twelvelabs.io>.
- > Note: There is **no mock fallback** for AI calls. If the provider/model fails or returns invalid output, the API will return an error directly.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.