本地优先的 AI 记忆系统,逐字保存对话历史,并通过语义搜索检索,提供 MCP 服务与命令行工具。
GhostPeony/clip-finder
自托管的 YouTube 字幕语义搜索工具,可跨频道、播放列表或单个视频查找内容并跳转到对应时间点。
- Star
- 55
- Fork
- 6
- 未关闭 Issue
- 0
- 最近提交
- 4个月前
这是什么?
SearchTube 可以索引 YouTube 频道、播放列表或单个视频的字幕,然后按语义而不是精确关键词进行搜索。每条结果都会链接到视频中对应的时间点,方便直接跳转到相关片段。
项目支持两种运行模式。本地模式无需登录,向量存储在本地 ChromaDB 目录中,Gemini 密钥由用户在浏览器中填写。Supabase 模式增加了用户认证、基于 pgvector 的 Postgres、用量配额和服务端托管的 Gemini 密钥,并可选择加密保存用户自己的密钥。
前端使用 React,后端使用 FastAPI,检索基于 Gemini 向量嵌入。项目还提供检索评估脚本,便于在更换嵌入模型或向量维度前对比效果。
核心功能
- 01基于字幕的语义搜索,结果带时间戳链接
- 02支持频道、播放列表和单个视频的索引
- 03自动跳过已索引的视频
- 04本地模式无需登录,Supabase 模式支持多用户登录
- 05支持在浏览器中填写自己的 API 密钥,或加密存储在服务端
- 06可下载 SRT 格式字幕并查看最近搜索记录
适用场景
- 在长系列课程或教程频道中定位某个知识点的讲解
- 在播放列表中按主题快速查找内容,无需逐个观看
- 为团队或个人搭建私有化的字幕搜索服务
快速上手
- 1
克隆代码仓库
git clone https://github.com/GhostPeony/SearchTube.git - 2
创建 Python 虚拟环境并安装后端依赖
python -m venv venv venv\Scripts\activate pip install -r requirements.txt - 3
安装前端依赖,然后创建包含 Gemini API 密钥的 .env.local
npm install - 4
在一个终端启动后端,另一个终端启动前端,然后打开 http://localhost:3001
python backend/server.py npm run dev
使用前须知
- 本地模式需要 Gemini API 密钥用于向量嵌入和搜索。
- 安装说明中的虚拟环境激活命令针对 Windows,其他系统需要使用不同的命令。
- 没有字幕或受地区、年龄限制的视频无法获取转录文本。
标签
常见问题
- clip-finder 是什么?
- 自托管的 YouTube 字幕语义搜索工具,可跨频道、播放列表或单个视频查找内容并跳转到对应时间点。 SearchTube 可以索引 YouTube 频道、播放列表或单个视频的字幕,然后按语义而不是精确关键词进行搜索。每条结果都会链接到视频中对应的时间点,方便直接跳转到相关片段。
- clip-finder 可以免费使用吗?用的什么许可证?
- clip-finder 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- clip-finder 还在维护吗?
- 半年内有更新。clip-finder 最近一次提交是在 2026年7月2日。
- clip-finder 适合用来做什么?
- 在长系列课程或教程频道中定位某个知识点的讲解 在播放列表中按主题快速查找内容,无需逐个观看 为团队或个人搭建私有化的字幕搜索服务
- clip-finder 怎么安装和运行?
- 克隆代码仓库: git clone https://github.com/GhostPeony/SearchTube.git 创建 Python 虚拟环境并安装后端依赖: python -m venv venv venv\Scripts\activate pip install -r requirements.txt 安装前端依赖,然后创建包含 Gemini API 密钥的 .env.local: npm install 在一个终端启动后端,另一个终端启动前端,然后打开 http://localhost:3001: python backend/server.py npm run dev
- 在哪里获取 clip-finder?
- 源代码和安装说明在 GitHub 上:https://github.com/GhostPeony/clip-finder
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
6万7569PythonMIT更新于 9小时前
面向 AI 应用的开源数据基础设施,用于存储文档与向量并支持语义、混合及全文检索。
3万2571RustApache-2.0更新于 17小时前
北京智源推出的检索工具包,提供 BGE 向量模型与重排序模型,并包含微调、评测和教程,用于搜索与 RAG。
1.2万1105PythonMIT更新于 2个月前
自托管推理服务器,通过兼容 OpenAI 的 API 在一个集群中提供嵌入、重排序、OCR、抽取和大模型等多种模型。
3414323PythonApache-2.0更新于 昨天
基于 DeepSeek-OCR 的网页应用,可对图片和 PDF 做文字识别,并导出为多种格式。
1892311JavaScriptMIT更新于 7个月前
从英语知识点一站式生成 30 秒竖屏中文字幕英语教学视频的 AI 创作工具。
18221Python无许可证更新于 2个月前