pipeshub-ai

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 652 🐛 待处理 224 👀 关注 18

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4042

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0 许可证，可自行部署使用，无付费版本。

项目预览

项目数据

分类搜索知识

开发团队pipeshub-ai

官网地址https://pipeshub.com

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agentic-rag,ai,ai-agents,claude-code,context-engineering,context-layer,deep-research,enterprise-search,glean,graphrag,hybrid-search,knowledge-graph,llm,mcp,mcp-server,ollama,python,rag,self-hosted,workplace-ai

GitHub 星标★ 4042

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

代码更新2026-11-07

仓库体积201.2 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4042

技术标签

agentic-rag ai ai-agents claude-code context-engineering

使用教程

难度：入门约 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。