Serviette

Serviette 简介

Serviette 是一个基于 Pathway 实时数据框架构建的无代码 RAG 服务器。你只需将文档文件夹指向它，在 YAML 中配置向量数据库和嵌入模型，运行两条命令，即可获得一个能引用来源的聊天界面和 REST API。文档的任何修改、新增或删除都会在几秒内反映到答案中。

核心特性

• 无代码配置：通过 serviette wizard 生成配置文件，或手动编辑 YAML。
• 实时增量更新：基于 Pathway 的流式处理，文档变更自动同步到向量数据库。
• 多向量数据库支持：DuckDB（默认，零配置）、pgvector、Qdrant、Milvus、ChromaDB、Weaviate、Pinecone、MongoDB Atlas。
• 多源接入：本地文件系统、Google Drive、S3/MinIO、SharePoint，以及 PyFilesystem 支持的 FTP、SFTP、WebDAV 等。
• 多模态解析：文本、Office 文档、PDF（含表格和布局）、扫描图片，配置 API 密钥后还可处理音频和视频。

快速体验

pip install serviette
export PATHWAY_LICENSE_KEY=...   # 免费获取：https://pathway.com/framework/get-license
export OPENAI_API_KEY=sk-...
serviette demo --embedder openai  # 打开 http://localhost:8989 聊天界面

建议使用 pip 23.1 或更高版本。

使用自己的文档

pip install "serviette[local]" --extra-index-url https://download.pytorch.org/whl/cpu
export PATHWAY_LICENSE_KEY=...
export OPENAI_API_KEY=sk-...
serviette wizard                    # 交互式生成 config.yaml
serviette up --config config.yaml   # 启动索引器和服务 → http://localhost:8989

服务同时提供 Web 聊天界面和版本化 REST API（/api/v1），例如：

curl -X POST http://localhost:8989/api/v1/retrieve \
  -H 'Content-Type: application/json' \
  -d '{"query": "如何实现持久化？", "k": 5}'

适用场景

• 企业内部文档问答助手
• 个人知识库实时检索
• 多格式文档语义搜索
• 快速搭建 RAG 原型

注意事项

• 需要免费的 Pathway 许可证密钥（GitHub 或 LinkedIn 登录获取）。
• 当前仅支持单轮问答，对话记忆、用户账户等功能尚未内置。
• 默认使用本地嵌入模型，数据不出本地；若使用 API 嵌入，文档文本会发送至相应服务。
• 生成答案需要配置模型 API（如 OpenAI），也可无密钥运行，此时答案直接引用检索片段。