Colpali

Colpali

vidore ColPali v1.3 模型的 Gradio 演示，自带一个存好的页面嵌入文件。适合想在浏览器里试用视觉文档检索的开发者和研究者，在 Hugging Face 上运行。

由 rayyan0 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这是围绕 vidore colpali-v1.3-hf 模型搭的 Gradio 演示。它的仓库里带有一个名为 pages_embeddings.pt 的已存嵌入文件，这暗示应用是把查询和预先算好的页面数据做匹配。README 是空的，所以页面本身说得不多。它在 Hugging Face 的 zero-a10g 硬件上运行。

适合谁：想不用自己搭建就在文档上试用 ColPali 模型的开发者和研究者，以及想看一个小例子，了解它是怎么被封装进应用的人。

Industry | Who uses it | How they use it | Example
研究 | 检索研究者 | 在已存的页面嵌入上试用模型 | 跑几个查询，看看匹配到什么
软件 | 开发者 | 阅读 app.py，看模型和嵌入是怎么加载的 | 把这套布局复用到自己的文档搜索上
教育 | 学生 | 学习文档检索演示是怎么做的 | 改一个查询，看结果怎么变

如果你需要搜索自己的文件，可以跳过它，因为页面只提到了一个自带的嵌入文件。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 的页面里
• 你自己的电脑，作为本地副本，前提是装好了 Python 3.12

Use case | Who | What they get back
试用模型 | 研究者 | 在网页表单里得到 ColPali 模型的结果
研究这个演示 | 开发者 | 一个简短的 Gradio 应用和一个可以阅读的嵌入文件

如何设置：

• 如果只用在线 Space，就什么都不用装
• 本地副本需要 Python 3.12 和 pip
• requirements.txt 里列出的 Python 包

1. 想在线使用，就打开 Hugging Face 上这个 Space 的页面。
2. 想要本地副本，先安装 Hugging Face hub 包，再下载这个 Space。
3. 进入新文件夹，安装指定版本的 Gradio。
4. 安装 requirements.txt 里的包。
5. 用 Python 启动应用。

pip install -U huggingface_hub
hf download rayyan0/colpali --repo-type space --local-dir colpali
cd colpali
pip install gradio==6.31.0
pip install -r requirements.txt
python app.py

这个仓库有五个文件，包括 app.py、requirements.txt 和嵌入文件。页面没有说明本地运行除了这些包还需要什么。

如何使用：在线使用时，打开这个 Space，用页面上的表单操作。在自己的电脑上，运行应用文件，然后在浏览器里打开 Gradio 提供的页面。页面没有列出其他命令。

Tool | What it does
python app.py | 在你的电脑上启动 Gradio 应用

示例：你打开这个 Space，在表单里输入一个简短的问题。应用把模型对着它存好的页面数据运行，并显示找到的内容，你可以读一读，看匹配得和你的问题有多贴切。

新手与专家：如果你是新手，先在线打开这个 Space，试一个简短的问题。README 是空的，所以请以页面上看到的内容为准。

如果你熟悉这个领域，已存的 pages_embeddings.pt 文件说明这是对预先算好的页面向量做检索，而不是实时建索引。页面没有给出语料、评分细节，也没有说明如何加入你自己的页面。

在浏览器里打开 Space
输入一个查询
ColPali 模型把它和已存页面比较
显示匹配结果

注意事项：

• License: mit
• Cost to run: 没有提到费用，不过这个 Space 在 Hugging Face 的 zero-a10g 硬件上运行
• Data it reaches: 你的查询、自带的嵌入文件，以及来自 Hugging Face 的模型文件
• Not for: 搜索你自己的文档，因为页面没有描述加入它们的办法

Hugging Face 上的数据（2026年11月13日）

• 点赞：1
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/rayyan0/colpali
• 文件：https://huggingface.co/spaces/rayyan0/colpali/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。