persian-rag demo

persian-rag demo

在浏览器里通过 Pyodide 试用波斯语文本规范化，以及对 34 段示例文字的 BM25、稠密或混合检索。不需要服务器，不用下载模型，也不用 API 密钥。

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

简介

它是什么：这个 Space 是 persian-rag 的小型浏览器演示，persian-rag 是一个以波斯语为先的检索增强生成 Python 工具包。这个库不需要其他包，所以演示通过 Pyodide 直接在你的浏览器里运行它，不需要服务器。

演示涵盖两件事。它会检索自带的 34 段波斯语文字，也会规范化波斯语文本。回答生成被有意去掉了。

适合谁：适合为波斯语文本构建搜索或问答、想先试用这个库的人，也适合想看 Python 怎样在静态页面里运行的开发者。

Industry | Who uses it | How they use it | Example
自然语言处理 | NLP 工程师 | 在波斯语段落上比较关键词、稠密和混合检索 | 看倒数排名融合怎样改变排序
搜索与知识工具 | 搜索开发者 | 测试拼写变体改写 | 匹配同一个波斯语词的不同写法
研究 | 语言研究者 | 查看规范化改变了哪些字符 | 检查阿拉伯语和波斯语字母形式是怎样统一的
教育 | 学生 | 不装任何东西就试用演示 | 在加入模型之前先了解检索是怎么回事

如果你想要完整的问答系统，可以跳过，因为演示去掉了回答生成。

用在哪里：这个演示可以在下面这些地方运行。

• 网页浏览器，在 Hugging Face 上的 Space 页面里
• Windows、macOS 或 Linux 上的网页浏览器，从由静态文件服务器提供的本地副本打开
• 你自己的 Python 代码，通过 persian-rag 包

Use case | Who | What they get back
检索波斯语段落 | 开发者 | BM25、稠密或混合检索的排序结果
规范化波斯语文本 | 研究者 | 清理后的文本，并列出改变的码位
试用拼写变体 | 搜索构建者 | 跨不同写法的匹配

如何设置：在线使用只需要浏览器。本地副本需要下面这些。

• Python 和 pip，用于 hf download 命令
• 一个网页浏览器
• 任意静态文件服务器，比如 Python 自带的那个

1. 安装 huggingface_hub 包。
2. 用 hf 命令把 Space 的文件下载到一个文件夹里。
3. 进入这个文件夹。
4. 用静态文件服务器提供这个文件夹。
5. 在网页浏览器里打开 8000 端口上的页面。

pip install -U huggingface_hub
hf download sadrmanesh/persian-rag-demo --repo-type space --local-dir persian-rag-demo
cd persian-rag-demo
python -m http.server

如果你想在自己的项目里用这个库，下面的命令会安装 0.4.0 版本。

pip install persian-rag==0.4.0

如何使用：打开 Space 页面，选一种检索模式，然后输入波斯语查询。你可以打开或关闭拼写变体改写，也可以对一段文本运行规范化，看哪些码位被改变了。

Tool | What it does
BM25 | 按段落的词与查询的匹配程度排序
Dense | 按嵌入相似度排序，不过演示里的分数并不反映语义
Hybrid | 用倒数排名融合把两种排序合在一起
Variant rewriting | 让一个词按它的不同写法互相匹配，比如城市名德黑兰的两种常见写法
Normalization | 统一阿拉伯语的 Yeh 和 Kaf、数字、半空格和标点

示例：你输入一个波斯语查询并选混合检索。页面返回自带的 34 段文字里最匹配的段落，打开变体改写后，它还会找到把某个词拼成另一种写法的段落。

新手与专家：如果你是新手，打开 Space 页面，先试规范化。它会让你看到不同的键盘怎样用不同方式输入同一个波斯语字母。

如果你熟悉这个领域：演示用 HashingEmbedder 给文本做嵌入，它可以离线工作。因此它的稠密分数并不带有语义含义。在真实语料上，README 建议用 SentenceTransformerEmbedder，从 0.4.0 起它的默认模型是 multilingual-e5-small，并自动加上 E5 前缀，或者用兼容 OpenAI 的嵌入器。

打开页面，Pyodide 加载
输入波斯语查询或文本
库进行检索或规范化
显示结果并列出改变之处

注意事项：语料和问题来自 persian-rag 检索基准。demo.py 放着演示的 Python 部分，仓库里还有一个构建好的 0.4.0 包文件。

• License: MIT
• Cost to run: 未提及，演示也不要求密钥或模型文件
• Data it reaches: 仓库里自带的段落和基准数据
• Not for: 生成回答，因为演示去掉了回答生成

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

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

链接

• Space：https://huggingface.co/spaces/sadrmanesh/persian-rag-demo
• 文件：https://huggingface.co/spaces/sadrmanesh/persian-rag-demo/tree/main

试用

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