pipeshub-ai

统一企业数据，让 AI 搜索和智能体更懂业务

PipesHub 是一个开源的 AI 上下文层，旨在统一企业分散的业务数据，为可解释的企业搜索和智能体工作流自动化提供支持。它解决了企业内部数据孤岛问题，通过连接各种数据源（如数据库、文档、API 等），构建统一的数据访问层，使 AI 模型能够基于完整、准确的上下文进行推理和回答。核心能力包括：数据源连接与同步、语义搜索、可解释的检索结果（提供来源和推理路径）、以及支持构建自主智能体工作流。项目采用 Python 编写，提供灵活的扩展机制，允许开发者自定义数据连接器和处理逻辑。目前处于成长阶段，GitHub 星标超过 3000，社区活跃度较高。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3769

维护状态活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队pipeshub-ai

所属国家

官网地址https://pipeshub.com

GitHubhttps://github.com/pipeshub-ai/pipeshub-ai

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自行部署使用，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agent,agents,ai,docker,enterprise-search,fastapi,glean,graphrag,knowledge-graph,langchain,langgraph,mcp,notion,ollama,python,rag,retrieval-augmented-generation,self-hosted,slack,workplace-ai

GitHub 星标★ 3769

30天Star增速

HF 下载量

上线时间2025-03-06 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 15 分钟部署方式：Docker 7 步

环境要求

已安装 Docker，且包含 Compose v2
满足安装器检查的 RAM 与磁盘前提条件
可访问网络的终端环境（需使用 curl 与 bash）
云服务器部署时需准备 HTTPS 端点（Cloudflare / Nginx / Traefik）

安装与启动步骤

1检查 Docker 环境

确认本机已安装 Docker 且支持 Compose v2，安装脚本会在启动时自动检查 Docker、内存与磁盘。
```
docker compose version
```
2一键安装启动

官方推荐方式：下载最新发布版部署文件到 ./pipeshub 并启动交互式安装器，全程自动生成 .env 并拉起容器。
```
curl -fsSL https://get.pipeshub.com/install | bash
```
3先审阅脚本再运行

若希望运行前检查脚本内容，可先下载保存，用 less 查看确认无误后再用 bash 执行。
```
curl -fsSL https://get.pipeshub.com/install -o pipeshub-install.sh
less pipeshub-install.sh
bash pipeshub-install.sh
```
4完成交互式配置

按提示选择 slim 或 full 部署，可选自定义图数据库、消息代理与 KV 存储，安装器会生成随机密钥并写入 .env。
5打开 Web 界面

安装器会拉取镜像、启动服务栈并等待健康检查通过，完成后浏览器访问本地 3000 端口即可。
6源码方式构建部署

如需从源码构建本地镜像，先克隆仓库，再在仓库根目录执行带 --build 的安装脚本。
```
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai
./install.sh --build
```
7查看容器日志

部署出现异常时，用 compose 日志命令查看各服务输出，定位启动失败原因。
```
docker compose logs
```

关键配置

配置项	必填	说明	示例
`.env`	是	安装器自动生成的配置文件，包含随机密钥等部署参数	`由安装器自动生成`
`env.template`	否	环境变量模板文件，用于核对可配置的环境变量项	`env.template`
`--version TAG`	否	安装参数：固定使用某个镜像版本标签	`--version 0.7.0`

如何确认成功

安装器等待 PipesHub 健康检查通过并打印访问地址，浏览器打开 http://localhost:3000 能看到界面即成功。

常见问题

Q：部署完成后页面白屏怎么办？

A：通常是纯 HTTP 访问导致浏览器拦截部分请求。云服务器请配置 HTTPS 端点（Cloudflare、Nginx 或 Traefik 终止 TLS）后重试。

Q：如何从源码构建而不是用预构建镜像？

A：克隆仓库后在根目录执行 ./install.sh --build，一键安装脚本始终使用预构建镜像。

Q：如何跳过交互式提问？

A：安装器支持 -y / --yes 接受全部默认值，适合 CI 环境；也可用 --print-env-only 只生成 .env 不启动容器。

Q：如何固定镜像版本或重写配置？

A：使用 --version TAG 指定镜像标签，使用 --reconfigure 重新运行向导并覆盖已有 .env。

Q：部署失败如何排查？

A：先确认云端已启用 HTTPS，再执行 docker compose logs 查看日志，并核对 env.template 中的环境变量。

注意事项

一键安装脚本使用预构建镜像，源码构建必须走克隆仓库后 ./install.sh --build 的路径。
云服务器上请务必使用 HTTPS，纯 HTTP 部署常导致前端白屏。
安装器会检查 Docker、RAM 与磁盘前提条件，未通过时请先补齐环境。
更多高级选项（CI 环境变量、slim/full 部署类型、手动 Compose profile）见 deployment/docker-compose/ADVANCED_DEPLOYMENT.md。

核心亮点

提供统一的数据访问层，解决多源数据整合难题
强调可解释性，搜索结果附带来源和推理路径
支持智能体工作流自动化，扩展性强

不足之处

项目较新，文档和社区生态待观察
企业级部署和性能优化可能需要额外投入

适用场景

企业内部知识库的智能问答与搜索
跨部门数据整合与自动化报告生成
构建基于业务上下文的 AI 智能助手

替代项目

LlamaIndex、Haystack、LangChain

项目介绍

pipeshub-ai 是基础设施领域的开源项目，由 pipeshub-ai 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,769）位列前 30%，在基础设施分类中处于中上游。

近 42 天，它的 GitHub 星标从 3,189 增加到 3,769，净增 580。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可自行部署使用，无付费版本。

它主要面向的使用场景是：企业内部知识库的智能问答与搜索。同类可对比的替代方案包括 LlamaIndex、Haystack、LangChain。

上一篇：morphik-core

下一篇：fastembed