项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3049
使用教程
环境要求
- 已安装并正在运行 Docker(Docker Desktop 等)
- 可访问 Docker Hub 与 GitHub 的网络环境
- 可选:自有 OpenAI API Key(用于实时 RAG 生成答案)
- 可用端口 8000(SWIRL 默认 Web 端口)
安装与启动步骤
-
1确认 Docker 已运行
确保本机已安装 Docker 应用并处于运行状态,否则后续 docker-compose 命令无法执行。
-
2下载 compose 文件
从官方仓库拉取 docker-compose.yaml 到当前目录,后续启动都基于该文件。
curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml -
3配置 OpenAI 密钥(可选)
如需要用自己的 OpenAI Key 启用实时 RAG,先导出这三个环境变量,再启动服务,否则可跳过。
export MSAL_CB_PORT=8000 export MSAL_HOST=localhost export OPENAI_API_KEY='sk-xxxxxxxx' -
4拉取并启动 SWIRL
拉取镜像并启动容器,首次运行需要下载镜像,请耐心等待命令执行完毕。
docker-compose pull && docker-compose up -
5登录并试用搜索
浏览器打开 Galaxy 界面,用默认账号 admin / password 登录,即可体验开箱即用的搜索。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 否 | 自有 OpenAI 密钥,用于启用实时 RAG 生成带引用的答案 | sk-xxxxxxxx |
MSAL_CB_PORT | 否 | 回调端口配置,示例与 Web 端口一致为 8000 | 8000 |
MSAL_HOST | 否 | 回调主机名配置,本地部署填 localhost | localhost |
如何确认成功
浏览器访问 http://localhost:8000/galaxy,用 admin / password 登录并成功执行一次搜索。
常见问题
Q:需要向量数据库或先做 ETL 吗?
A:不需要。SWIRL 直接实时查询你的数据源,按用户自身权限取数并重排结果,不复制第二份数据,也没有向量库。
Q:默认能搜哪些数据源?
A:开箱即可搜索 Arxiv、European PMC 和 Google News 三个源,无需额外配置即可直接运行搜索。
Q:不填 OpenAI Key 能用吗?
A:可以。该变量是可选项,只有启用实时 RAG 生成答案时才需要,不配置仍可正常检索和排序结果。
Q:关闭容器后配置丢失怎么办?
A:Docker 版本关闭后不保留数据与配置,需要持久化安装请参考官方 Quick Start Guide 文档。
注意事项
- Docker 版本在关闭后不会保留数据与配置,仅适合试用
- 如需持久化部署,请查看官方 Quick Start Guide 文档
- 这是 Apache 2.0 的社区版,可自由自托管;企业版额外提供三段式重排、规范答案与 MCP 服务器
- 默认登录口令为 admin / password,正式使用前建议修改
核心亮点
- 无需迁移数据即可统一检索100+应用,降低数据接入成本
- 支持联邦查询与RAG结合,直接基于企业现有数据生成答案
- 部署快速,分钟级完成,适合快速验证AI搜索场景
不足之处
- 项目处于成长阶段,文档/社区待观察
- 依赖Django框架,可能对轻量部署不够友好
适用场景
- 企业内部多系统知识统一搜索与问答
- 数据敏感场景下需保留数据原位时的AI检索
- 快速搭建跨应用元搜索原型
替代项目
Haystack、txtai、MindsDB
下一篇:SeekStorm
同类项目推荐
VisRAG
开源
不解析文档,直接看图检索,提升 RAG 准确率
Parsing-free RAG supported by VLMs
kg-rag
开源
跟着书学 GraphRAG,用图数据库做出更聪明的聊天机器人
Supporting repository for the Essential GraphRAG book published by Manning
contoso-chat
开源
一键跑通 Azure RAG 应用,从代码到评估部署全流程
This sample has the full End2End process of creating RAG application with Prompty an···
Local_Pdf_Chat_RAG
开源
本地PDF秒变知识库,和大模型聊天提问
Transparent Python RAG reference with FAISS + BM25 hybrid retrieval, reranking, Grad···
ai-research-assistant
开源
用大白话提问,自动查资料写报告,省下几小时文献苦工。
Aria is Your AI Research Assistant Powered by GPT Large Language Models
docsagent
开源
让 AI 秒读你的 Zotero 文献库,本地私密检索
⚡ DocsAgent — give your AI agents instant, private access to your personal knowled···
Starcat
开源
把吃灰的 GitHub Stars 变成能搜能问的私人知识库
A native macOS app that turns GitHub Stars into a searchable, organized, AI-powered ···
langextract
开源
从杂乱文本中精准抽取结构化数据,并可视化追溯来源
A Python library for extracting structured information from unstructured text using ···
anchr-app
开源
自托管文档知识库,混合检索加引用问答,数据不出内网
Self-hostable RAG backend for document knowledge: hybrid search, cited answers, and ···
