hf-space/README.md

---
title: Visual Product Search
emoji: 🔍
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.36.0
python_version: "3.10"
app_file: app.py
pinned: false
license: mit
---

# Visual Product Search API

AI-powered visual search using **Jina CLIP v2** embeddings.

## Features
- Upload an image to find visually similar products
- Uses Jina CLIP v2 for state-of-the-art image embeddings
- Queries Pinecone vector database for similarity search

## API Usage

```python
from gradio_client import Client

client = Client("YOUR_USERNAME/visual-search")
result = client.predict(
    "path/to/image.jpg",
    api_name="/predict"
)
print(result)
```

## Setup

Set these secrets in HuggingFace Space settings:
- `PINECONE_API_KEY`: Your Pinecone API key
- `PINECONE_HOST`: Your Pinecone index host (without https://)

## Model

Uses [jinaai/jina-clip-v2](https://huggingface.co/jinaai/jina-clip-v2) - a multilingual multimodal embedding model.
# Trigger rebuild - Thu Feb  5 08:26:22 +03 2026