pathwaycom/serviette

这是什么？

核心功能

• 01通过一个 YAML 文件完成配置，并提供交互式向导生成配置。
• 02支持 8 种向量数据库，默认使用无需额外安装的 DuckDB。
• 03实时监听数据源，文档修改和删除会在数秒内反映到索引中。
• 04可选启用 BM25 与向量混合检索、重排序、查询拆解和 MMR。
• 05聊天界面与 REST API 共用同一端口提供服务。

适用场景

• 为企业内部文档搭建问答助手，文件更新后答案随之同步。
• 使用 DuckDB 和本地免费 embedder 在本机快速验证 RAG 流程。
• 为已有向量数据库增加带来源引用的问答 REST 接口。

快速上手

1. 1

   用 pip 安装该包

   pip install serviette
2. 2

   设置免费的 Pathway 许可证密钥

   export PATHWAY_LICENSE_KEY=...
3. 3

   设置用于生成回答的 OpenAI API 密钥

   export OPENAI_API_KEY=sk-...
4. 4

   运行演示并在 localhost:8989 打开聊天页面

   serviette demo --embedder openai

使用前须知

• !运行前需要一个免费的 Pathway 许可证密钥。
• !每次只回答一个问题，没有对话记忆、用户账户或托管服务。
• !除非使用 CPU 版本参数，否则默认的本地嵌入需要安装较大的 PyTorch。

标签

常见问题

serviette 是什么？

无需编码的 RAG 服务，将文档目录索引到 8 种向量数据库中，文件变更后答案实时同步。 serviette 是一个通过单个 YAML 文件完全配置的检索增强生成（RAG）服务。你只需指定文档目录、向量数据库和 embedder，它就会提供网页聊天界面和版本化的 REST API（/api/v1），基于这些文档回答问题并标注来源。

serviette 可以免费使用吗？用的什么许可证？

serviette 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

serviette 还在维护吗？

活跃维护中。serviette 最近一次提交是在 2026年10月16日。

serviette 适合用来做什么？

为企业内部文档搭建问答助手，文件更新后答案随之同步。 使用 DuckDB 和本地免费 embedder 在本机快速验证 RAG 流程。 为已有向量数据库增加带来源引用的问答 REST 接口。

serviette 怎么安装和运行？

用 pip 安装该包: pip install serviette 设置免费的 Pathway 许可证密钥: export PATHWAY_LICENSE_KEY=... 设置用于生成回答的 OpenAI API 密钥: export OPENAI_API_KEY=sk-... 运行演示并在 localhost:8989 打开聊天页面: serviette demo --embedder openai

在哪里获取 serviette？

源代码和安装说明在 GitHub 上：https://github.com/pathwaycom/serviette