mcpField
C
clip

clip

github.com/orchestra-research数据与数据库14.1k965 次安装19 周前更新
代码仓库

关于 clip

介绍 OpenAI 的 CLIP 技术指南。该模型将图像和文本映射到相似度任务中,适合开发零样本图像分类、语义搜索、内容审核及跨模态检索流程。

主要功能

  1. 01零样本图像分类
  2. 02图像与文本相似度计算
  3. 03语义图像搜索
  4. 04内容审核分类
  5. 05批量图像编码

适用场景

  1. 01无需训练数据进行图像分类
  2. 02按文本描述检索图像
  3. 03对图像内容进行安全类别筛查
  4. 04构建图像到文本的跨模态检索

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/orchestra-research/ai-research-skills --skill clip

安装后在 Claude Code 中输入/clip确认已加载。

附带文件references/applications.md

详细介绍

CLIP - 对比式语言-图像预训练

OpenAI 的模型,可通过自然语言理解图像。

何时使用 CLIP

适用于:

  • 零样本图像分类(无需训练数据)
  • 图像与文本的相似度计算/匹配
  • 语义图像搜索
  • 内容审核(检测不适宜内容、暴力内容)
  • 视觉问答
  • 跨模态检索(图像→文本、文本→图像)

指标:

  • GitHub 星标数超过 25,300
  • 使用 4 亿组图像-文本对进行训练
  • 在 ImageNet 上的表现与 ResNet-50 相当(零样本)
  • MIT 许可证

可改用以下替代方案:

  • BLIP-2:图像描述效果更好
  • LLaVA:视觉语言对话
  • Segment Anything:图像分割

快速开始

安装
pip install git+https://github.com/openai/CLIP.git
pip install torch torchvision ftfy regex tqdm
零样本分类
import torch
import clip
from PIL import Image

# Load model
device = "cuda" if torch.cuda.is_available() else "cpu"
model, preprocess = clip.load("ViT-B/32", device=device)

# Load image
image = preprocess(Image.open("photo.jpg")).unsqueeze(0).to(device)

# Define possible labels
text = clip.tokenize(["a dog", "a cat", "a bird", "a car"]).to(device)

# Compute similarity
with torch.no_grad():
    image_features = model.encode_image(image)
    text_features = model.encode_text(text)

    # Cosine similarity
    logits_per_image, logits_per_text = model(image, text)
    probs = logits_per_image.softmax(dim=-1).cpu().numpy()

# Print results
labels = ["a dog", "a cat", "a bird", "a car"]
for label, prob in zip(labels, probs[0]):
    print(f"{label}: {prob:.2%}")

可用模型

# Models (sorted by size)
models = [
    "RN50",           # ResNet-50
    "RN101",          # ResNet-101
    "ViT-B/32",       # Vision Transformer (recommended)
    "ViT-B/16",       # Better quality, slower
    "ViT-L/14",       # Best quality, slowest
]

model, preprocess = clip.load("ViT-B/32")
模型参数量速度质量
RN50102M快良好
ViT-B/32151M中等更好
ViT-L/14428M慢最佳

图像-文本相似度

# Compute embeddings
image_features = model.encode_image(image)
text_features = model.encode_text(text)

# Normalize
image_features /= image_features.norm(dim=-1, keepdim=True)
text_features /= text_features.norm(dim=-1, keepdim=True)

# Cosine similarity
similarity = (image_features @ text_features.T).item()
print(f"Similarity: {similarity:.4f}")

语义图像搜索

# Index images
image_paths = ["img1.jpg", "img2.jpg", "img3.jpg"]
image_embeddings = []

for img_path in image_paths:
    image = preprocess(Image.open(img_path)).unsqueeze(0).to(device)
    with torch.no_grad():
        embedding = model.encode_image(image)
        embedding /= embedding.norm(dim=-1, keepdim=True)
    image_embeddings.append(embedding)

image_embeddings = torch.cat(image_embeddings)

# Search with text query
query = "a sunset over the ocean"
text_input = clip.tokenize([query]).to(device)
with torch.no_grad():
    text_embedding = model.encode_text(text_input)
    text_embedding /= text_embedding.norm(dim=-1, keepdim=True)

# Find most similar images
similarities = (text_embedding @ image_embeddings.T).squeeze(0)
top_k = similarities.topk(3)

for idx, score in zip(top_k.indices, top_k.values):
    print(f"{image_paths[idx]}: {score:.3f}")

内容审核

# Define categories
categories = [
    "safe for work",
    "not safe for work",
    "violent content",
    "graphic content"
]

text = clip.tokenize(categories).to(device)

# Check image
with torch.no_grad():
    logits_per_image, _ = model(image, text)
    probs = logits_per_image.softmax(dim=-1)

# Get classification
max_idx = probs.argmax().item()
max_prob = probs[0, max_idx].item()

print(f"Category: {categories[max_idx]} ({max_prob:.2%})")

批量处理

# Process multiple images
images = [preprocess(Image.open(f"img{i}.jpg")) for i in range(10)]
images = torch.stack(images).to(device)

with torch.no_grad():
    image_features = model.encode_image(images)
    image_features /= image_features.norm(dim=-1, keepdim=True)

# Batch text
texts = ["a dog", "a cat", "a bird"]
text_tokens = clip.tokenize(texts).to(device)

with torch.no_grad():
    text_features = model.encode_text(text_tokens)
    text_features /= text_features.norm(dim=-1, keepdim=True)

# Similarity matrix (10 images × 3 texts)
similarities = image_features @ text_features.T
print(similarities.shape)  # (10, 3)

与向量数据库集成

# Store CLIP embeddings in Chroma/FAISS
import chromadb

client = chromadb.Client()
collection = client.create_collection("image_embeddings")

# Add image embeddings
for img_path, embedding in zip(image_paths, image_embeddings):
    collection.add(
        embeddings=[embedding.cpu().numpy().tolist()],
        metadatas=[{"path": img_path}],
        ids=[img_path]
    )

# Query with text
query = "a sunset"
text_embedding = model.encode_text(clip.tokenize([query]))
results = collection.query(
    query_embeddings=[text_embedding.cpu().numpy().tolist()],
    n_results=5
)

最佳实践

  1. 大多数情况下使用 ViT-B/32 - 平衡性好
  2. 对嵌入向量进行归一化 - 计算余弦相似度所必需
  3. 批量处理 - 效率更高
  4. 缓存嵌入向量 - 重新计算成本高
  5. 使用描述性标签 - 零样本效果更好
  6. 建议使用 GPU - 速度快 10–50 倍
  7. 预处理图像 - 使用提供的 preprocess 函数

性能

操作CPUGPU (V100)
图像编码~200ms~20ms
文本编码~50ms~5ms
相似度计算<1ms<1ms

局限性

  1. 不适用于细粒度任务 - 更适合大类分类
  2. 需要描述性文本 - 模糊的标签效果较差
  3. 受网络数据偏差影响 - 可能存在数据集偏差
  4. 不提供边界框 - 仅处理整张图像
  5. 空间理解能力有限 - 对位置和计数的理解较弱

资源

评论

支持 Markdown