quaterion

几分钟搭好相似度模型训练,向量检索效果快速提升

开源 🏷️完全免费 ✅ 目前可打开 模型训练 🍴 复刻 46 🐛 待处理 15 👀 关注 8
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 665
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费框架,文档站提供使用指南

项目预览

quaterion 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类模型训练
开发团队qdrant
定价模式🏷️完全免费
价格说明开源免费框架,文档站提供使用指南
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型contrastive-learning,cosine-similarity,deep-learning,knn,machine-learning,metric-learning,nearest-neighbor-search,python,pytorch,pytorch-lightning,similarity-learning,similarity-search
GitHub 星标★ 665
上线时间2021-08-31 00:00:00
代码更新2026-10-05
仓库体积5.3 MB
本站数据更新2026-11-03
维护状态较活跃
收录时间2026-09-16
浏览次数1

项目介绍

Quaterion 是一个专注于相似度学习模型微调的 Python 框架,核心解决的是在检索、去重、聚类等场景下,如何高效训练出能输出高质量向量表示的模型。它把对比学习、度量学习、kNN 近邻搜索等常见流程封装成可复用的训练组件,内置多种损失函数(如对比损失、三元组损失)和采样策略,并针对训练速度做了大量工程优化,官方称比同类方案快数倍。框架基于 PyTorch,支持自定义编码器、数据加载器和评估器,适合需要快速迭代相似度模型的团队。相比从零手写对比学习训练循环,Quaterion 提供了更清晰的抽象和更少的样板代码,同时保留了对底层细节的控制力,可用于文本、图像等多种模态的嵌入微调任务。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 665

使用教程

难度:进阶 约 35 分钟 部署方式:本地安装 4 步

环境要求

  • Python 3.9+
  • PyTorch
  • 成对标注数据

安装与启动步骤

  1. 1安装

    相似度学习模型的微调框架,pip 装核心。

    pip install quaterion
  2. 2装模型依赖

    预训练模型单独一个包。

    pip install quaterion-models
  3. 3准备三元组数据

    相似学习依赖正负样本对,数据质量决定效果。

  4. 4训练并评估

    用验证集看嵌入的区分度,别只看 loss。

如何确认成功

训练后相似样本的嵌入距离明显更近

注意事项

  • 负样本采样策略影响很大,随机采样往往不够。
  • 评估要看检索指标而非分类准确率。

核心亮点

  • 内置多种对比/度量学习损失与采样器,减少手写训练循环的样板代码
  • 针对训练速度做了工程优化,官方基准显示比同类框架更快
  • 基于 PyTorch,编码器、数据加载器和评估器均可自定义,灵活度较高

不足之处

  • 社区规模较小,生态和第三方教程相对有限
  • 文档和示例覆盖度一般,复杂场景需阅读源码

适用场景

  • 电商商品去重与相似商品召回模型微调
  • 文本语义检索或问答匹配的嵌入模型训练
  • 图像/多模态场景下的近邻搜索向量表示学习

替代项目

sentence-transformers、pytorch-metric-learning

上一篇:Qwen-VL-Series-Finetune

下一篇:physicsnemo

同类项目推荐

finetune-SAM 开源

把通用分割模型SAM微调到你的医学图像上,提升精度

This is an official repo for fine-tuning SAM to customized medical images.

★ 279 2026-08-09
AMD-LLM 开源

在 AMD GPU 上快速跑通 1.35 亿参数语言模型训练

Training code and resources for AMD-135M language models on AMD GPUs.

★ 195 2026-08-09
Prism 开源

动态稀疏注意力,让2K音视频生成模型原生训练更省算力

We propose Prism, a dynamic sparse attention framework for natively training joint v···

★ 1501 2026-10-26
rlix 开源

让 RL 实验排队更聪明,GPU 等待时间更短

Run more RL experiments. Wait less for GPUs.

★ 300 2026-08-09
aimet 开源

不重训模型,把已训练网络压到 4bit 还能保住精度

AIMET is a library that provides advanced quantization and compression techniques fo···

★ 2744 2026-10-17
JetSpec 开源

让大模型推理更快:并行草稿树突破推测解码速度天花板

JetSpec++/JetSpec: Causal Parallel (Tree) Drafting with Self Refinement

★ 255 2026-08-09
finetrainers 开源

用有限显存微调视频扩散模型,多卡也能跑

Scalable and memory-optimized training of diffusion models

★ 1363 2026-10-12
AutoGPTQ 开源

一键量化大模型,显存减半推理加速

An easy-to-use LLMs quantization package with user-friendly apis, based on GPTQ algo···

★ 5068 2026-08-09
diffusion-DDIM-pytorch 开源

快速上手 DDIM,用更少步数生成高质量图像

This is a pytorch implementation of Denoising Diffusion Implicit Models

★ 137 2026-08-09