# kk-local-image-search

**Repository Path**: clickwind/kk-local-image-search

## Basic Information

- **Project Name**: kk-local-image-search
- **Description**: 图片搜索图片搜索图片搜索图片搜索
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: v2
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 服务器端 启动
nohup streamlit run app_v2.py  >> ./logs/api_v2.log 2>&1 &
nohup uvicorn api_server:app --host 0.0.0.0 --port 8002  >> ./logs/api_server.log 2>&1 &

## Qwen3-VL-Embedding 特征提取策略

### 策略说明

基于 Qwen3-VL-Embedding 多模态嵌入模型，直接将图片编码为特征向量（不走文本描述中间步骤）。

提供两种模式，通过配置 `strategy.type` 切换：

### 本地模式（推荐）

直接加载模型到本地，图片→向量，支持 GPU 加速和批量处理。

```json
{
  "name": "image_vector_qwen3_vl",
  "dimension": 2048,
  "strategy": {
    "type": "qwen3_vl_embedding",
    "model": "Qwen/Qwen3-VL-Embedding-2B",
    "input_mode": "image"
  }
}
```

支持 MRL 截断（可在 dimension 指定 1024/512/256 等更小维度）。

### API 模式（通过 Ollama）

```json
{
  "name": "image_vector_qwen3_vl",
  "dimension": 2048,
  "strategy": {
    "type": "qwen3_vl_embedding_api",
    "model": "MedAIBase/Qwen3-VL-Embedding:2b-fp16",
    "api_base": "http://localhost:11434/v1"
  }
}
```

### 切换方式

`configs/multi_vector_default.json` 中改对应字段的 `strategy.type` 即可：
- `"type": "qwen3_vl_embedding"` → 本地加载
- `"type": "qwen3_vl_embedding_api"` → Ollama API