Frappe Image Search
Item Search perform using item image
- Author: manavmandli
- Repository: https://github.com/manavmandli/frappe_image_search
- GitHub stars: 1
- Forks: 3
- License: MIT
- Category: Developer Tools
- Maintenance: Actively Maintained
Install Frappe Image Search
bench get-app https://github.com/manavmandli/frappe_image_search
Add the Frappe Gems badge to your README
Maintain Frappe Image Search? Paste this into your README:
[](https://frappegems.com/gems/apps/manavmandli/frappe_image_search)
About Frappe Image Search
# Frappe Image Search
Visual similarity search for ERPNext Items — upload a product image and instantly find matching items ranked by similarity score.
---
---
## Installation
```bash
bench get-app https://github.com/your-org/frappe_image_search
bench install-app frappe_image_search
bench --site migrate
```
## Quick Start
1. Open any **Item** in ERPNext and set an image in the `Image` field.
2. Build the search index (run once, or after bulk item updates):
```bash
bench --site execute frappe_image_search.search.rebuild_index
```
3. Go to **`/app/image-search`** in the Frappe Desk.
4. Drag-and-drop or upload a product image → click **Search**.
5. Matching items appear with a **Match %** similarity score.
> Saving an Item with an image automatically updates its index entry.
## How Similarity Works
Each item image is converted to a 1286-dimensional vector combining:
- **Spatial colour histograms** — where colours appear in the image
- **HOG** (Histogram of Oriented Gradients) — shape and edge structure
- **LBP** (Local Binary Patterns) — surface texture (e.g. chain links vs smooth metal)
- **Grayscale thumbnail** — coarse intensity layout
Search computes cosine similarity between the uploaded image and all indexed items.
## License
MIT
Related Developer Tools apps for Frappe & ERPNext
- Frappe — Low code web framework for real world applications, in Python and Javascript
- Frappe Docker — Docker environment for developing, deploying, and running Frappe applications (ERPNext and custom apps) in production and development
- Builder — Craft beautiful websites effortlessly with an intuitive visual builder and publish them instantly
- Bench — CLI to manage Multi-tenant deployments for Frappe apps
- Frappe Ui — A set of components and utilities for rapid UI development
- Press — Full service cloud hosting for the Frappe stack - powers Frappe Cloud
- Gameplan — Open Source Discussions Platform for Remote Teams
- Doppio — A Frappe app (CLI) to magically setup single page applications and Vue/React powered desk pages on your custom Frappe apps.