swirlai/swirl-search

这是什么？

核心功能

• 01实时查询已接入的数据源，数据保留在原处。
• 02提供 100 多个连接器，并支持通过 OAuth2 集成 Microsoft 365。
• 03使用你自己的 OpenAI API Key 生成带引用的答案。
• 04基于余弦相似度重新排序结果，并支持重复结果检测。
• 05提供 REST API，可同步或异步发起联邦查询。
• 06连接器和结果合并器都是可扩展的 Python 对象。

适用场景

• 在 SharePoint、Confluence 和云盘之间统一搜索企业知识库，并附带来源链接。
• 搭建客服助手，基于文档和工单生成有依据的回复草稿。
• 构建开发者助手，同时检索 GitHub、Jira 和文档。

快速上手

1. 1

   安装并启动 Docker 应用

2. 2

   下载 compose 文件

   curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml
3. 3

   拉取镜像并启动 SWIRL

   docker-compose pull && docker-compose up
4. 4

   打开 http://localhost:8000/galaxy，使用 admin / password 登录

使用前须知

• !Docker 快速启动方式在关闭后不会保留数据或配置。
• !实时 RAG 回答需要你自己的 OpenAI API 密钥。
• !社区版不包含企业版的三阶段重排序器、标准答案、MCP 服务器和托管支持。

标签

常见问题

swirl-search 是什么？

开源的联邦式 AI 搜索与 RAG 工具，实时查询各应用并附带来源作答，无需把数据复制到向量库。 SWIRL 是一个可自托管的搜索层，在用户提问时实时把查询发送到已接入的应用，汇总结果后重新排序，并可调用你选择的 LLM 生成带可点击引用的答案。由于直接在原数据源上查询，无需搭建向量数据库，也不用维护 ETL 管道，更不会产生需要额外保护的数据副本。

swirl-search 可以免费使用吗？用的什么许可证？

swirl-search 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

swirl-search 还在维护吗？

活跃维护中。swirl-search 最近一次提交是在 2026年10月27日。

swirl-search 适合用来做什么？

在 SharePoint、Confluence 和云盘之间统一搜索企业知识库，并附带来源链接。 搭建客服助手，基于文档和工单生成有依据的回复草稿。 构建开发者助手，同时检索 GitHub、Jira 和文档。

swirl-search 怎么安装和运行？

安装并启动 Docker 应用 下载 compose 文件: curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml 拉取镜像并启动 SWIRL: docker-compose pull && docker-compose up 打开 http://localhost:8000/galaxy，使用 admin / password 登录

在哪里获取 swirl-search？

源代码和安装说明在 GitHub 上：https://github.com/swirlai/swirl-search