Bỏ qua tới nội dung
Ông T.vn

PipesHub: tìm kiếm tri thức công ty có phân quyền cho người và AI — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về pipeshub-ai/pipeshub-ai — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: pipeshub-ai: tìm kiếm tri thức công ty có trích dẫn, theo quyền — hướng dẫn cài đặt và dùng →

PipesHub: tìm kiếm tri thức công ty có phân quyền cho người và AI — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

PipesHub là nền tảng mã nguồn mở (Apache-2.0) gom kiến thức từ Slack, Google Drive, Jira, GitHub, Microsoft 365 và hơn 50 nguồn khác vào một nơi. Người dùng và AI agent (qua MCP, SDK) hỏi đáp có trích dẫn nguồn, chỉ thấy những gì mình được phép xem. Cài đặt bằng một lệnh nếu máy đã có Docker với Compose v2.

PipesHub là một nền tảng mã nguồn mở giúp nối kiến thức nằm rải rác trong các hệ thống của công ty (Slack, Google Drive, Jira, Confluence, GitHub, Microsoft 365, Notion…) thành một chỗ để tìm kiếm. Bạn hỏi bằng ngôn ngữ tự nhiên, nó trả lời kèm trích dẫn về đúng đoạn tài liệu gốc. Cùng kho tri thức đó cũng có thể đưa cho AI agent của bạn dùng.

Vấn đề nó giải quyết rất quen: thông tin nằm ở chat, ở ổ đĩa, ở ticket, ở code, và không ai nhớ nó nằm đâu. Điểm đáng giá nhất là tìm kiếm có phân quyền. Mỗi người (hoặc agent hành động thay người đó) chỉ thấy những gì họ được phép xem ở hệ thống gốc. Nhờ vậy công ty không phải lo AI "lỡ miệng" nói ra tài liệu mật.

Repo hiện có khoảng 4.101 sao và 669 fork, dùng giấy phép Apache-2.0, ngôn ngữ chính là Python, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể tự cài trên máy chủ của mình bằng Docker, hoặc dùng bản PipesHub Cloud nếu không muốn tự vận hành. Xem video ngắn bên dưới để thấy nó hoạt động trước khi cài.

Ứng dụng

pipeshub-ai/pipeshub-ai

PipesHub nối Slack, Drive, Jira, GitHub, Microsoft 365 và 50+ nguồn khác thành một kho tri thức có phân quyền, để người và AI agent tìm kiếm, có trích dẫn.

★ 4.1kPythonApache-2.0
Xem repo trên GitHub
Video giới thiệu pipeshub-aiXem trên YouTubeXem trên Facebook

I.PipesHub làm được gì

Dưới đây là các tính năng chính, diễn giải theo lợi ích thực tế.

  • Hỏi đáp có trích dẫn. Mỗi câu trả lời kèm trích dẫn đến đúng khối nội dung trong tài liệu gốc. Bạn kiểm chứng được, không phải tin mù quáng vào AI.
  • Tìm kiếm có phân quyền. Các connector đồng bộ nội dung cùng với quyền truy cập của nó. Khi hỏi, hệ thống lọc theo quyền của người hỏi.
  • 50+ connector. Kết nối sẵn với nhiều hệ thống phổ biến, có đồng bộ theo thời gian thực và theo lịch.
  • Agent loop thay vì một lượt tìm rồi trả lời. Agent tự lập kế hoạch, gọi công cụ, đọc kết quả và tiếp tục cho đến khi đủ bằng chứng. Nó dùng bốn công cụ: tìm kiếm lai (ngữ nghĩa + từ khoá), grep (tìm đúng mã ticket, chuỗi lỗi, tên hàm), đi theo đồ thị tri thức (liên kết giữa tài liệu, người, ticket, pull request, cuộc trò chuyện), và đọc nguyên tài liệu thay vì chỉ tin một đoạn trích.
  • Dùng model nào cũng được, tự host được. README ghi "Bring Your Own Model": bạn chọn nhà cung cấp LLM, triển khai trong hạ tầng của mình, dữ liệu không rời khỏi hạ tầng đó.
  • Đa phương thức. Hiểu ảnh, sơ đồ, file scan và có tương tác bằng giọng nói.
  • Agent không cần code, hành động, artifact. Dựng agent bằng giao diện trực quan, thực thi hành động trên các công cụ doanh nghiệp, tạo báo cáo, biểu đồ, dashboard trong môi trường chạy code an toàn.
  • Mở cho lập trình viên. Có API, SDK (Python, TypeScript, Go), MCP, connector tự viết.

Về định dạng file, README ghi PDF (cả bản scan), Word, Excel, PowerPoint, Google Docs/Sheets/Slides, Markdown, HTML, CSV, văn bản thường và ảnh. Âm thanh và video có thể lưu nhưng chưa được lập chỉ mục.

Về hiệu năng, tác giả công bố một số bài đo. Trên EnterpriseRAG-Bench (do Onyx chạy độc lập), PipesHub đứng số 1 trong 39 hệ thống với 93,24 điểm. Các bài đo còn lại (FRAMES, so với connector riêng từng app, đồ thị code) do chính đội PipesHub chạy, nên bạn cứ xem như tham khảo.

II.Cần chuẩn bị gì

Theo README, cách cài chính chỉ đòi hỏi:

  • Docker kèm Compose v2. Đây là điều kiện duy nhất README nêu cho cách cài nhanh.
  • Đủ RAM và ổ đĩa. Trình cài đặt sẽ tự kiểm tra Docker, RAM và dung lượng đĩa. README không nêu con số cụ thể ở phần đọc được, nên bạn xem thêm trong tài liệu chính thức nếu máy yếu.
  • Tài khoản và key của các hệ thống muốn kết nối. Ví dụ Slack, Google Drive, Jira. Chi tiết từng connector nằm ở trang tài liệu connector của PipesHub.
  • Một nhà cung cấp LLM. README nói bạn dùng được bất kỳ nhà cung cấp nào, nhưng không liệt kê cách khai báo trong phần đọc được. Bạn sẽ cần key của nhà cung cấp mình chọn.
  • HTTPS nếu cài trên máy chủ đám mây. Trình duyệt chặn một số yêu cầu qua HTTP thường. README khuyên dùng Cloudflare, Nginx hoặc Traefik để làm HTTPS.

Về hệ điều hành: README không nói rõ Windows có được hỗ trợ hay không. Lệnh cài là một script bash, nên bạn cần môi trường chạy được bash (Linux, macOS, hoặc cách tương đương trên Windows). Bạn nên kiểm tra thêm trong tài liệu chính thức trước khi cài.

PipesHub sẽ được cấp quyền đọc dữ liệu của công ty qua các connector. Hãy thử với một nguồn nhỏ, không nhạy cảm trước, và chỉ cấp đúng quyền cần thiết cho từng tài khoản kết nối.

III.Cài đặt từng bước

  1. Kiểm tra DockerĐảm bảo máy có Docker và Compose v2
  2. Chạy lệnh càiMột lệnh curl tải file triển khai và mở trình cài tương tác
  3. Trả lời câu hỏiChọn bản slim hoặc full, tuỳ chỉnh nếu muốn
  4. Chờ khởi độngTrình cài kéo image, chạy và báo địa chỉ
  5. Mở trình duyệtVào http://localhost:3000

A.Kiểm tra Docker

Cài Docker theo hướng dẫn chính thức, rồi chắc chắn là bản có Compose v2. Người mới hay vấp ở chỗ cài Docker xong nhưng chưa bật Docker lên. Hãy mở ứng dụng Docker và chờ nó báo đang chạy trước khi đi tiếp.

B.Chạy lệnh cài một dòng

Mở terminal (nơi bạn gõ lệnh) rồi chạy:

Terminal
curl -fsSL https://get.pipeshub.com/install | bash

Lệnh này tải file triển khai của bản phát hành mới nhất vào thư mục ./pipeshub rồi mở trình cài đặt tương tác. Thư mục pipeshub sẽ nằm ngay tại nơi bạn đang đứng trong terminal.

Nếu bạn muốn đọc script trước khi chạy (nên làm vậy với bất kỳ script nào tải từ mạng), README hướng dẫn:

Terminal
curl -fsSL https://get.pipeshub.com/install -o pipeshub-install.sh
less pipeshub-install.sh        # review it
bash pipeshub-install.sh

Dòng đầu tải script về file, dòng hai mở ra để bạn đọc (thoát bằng phím q), dòng ba mới thực sự chạy.

C.Trả lời các câu hỏi của trình cài

Trình cài sẽ làm lần lượt các việc sau:

  • Kiểm tra Docker, RAM và ổ đĩa.
  • Hỏi bạn muốn bản slim hay full.
  • Cho phép tuỳ chỉnh graph DB, message broker và KV store (không bắt buộc).
  • Tạo các khoá bí mật ngẫu nhiên và ghi vào file .env.
  • Kéo image và chạy toàn bộ hệ thống.
  • Chờ PipesHub khoẻ, kiểm tra truy cập được rồi in ra địa chỉ.

Nếu chưa chắc, cứ chọn mặc định. Đừng xoá file .env vì nó chứa các khoá bí mật vừa tạo.

D.Cài từ mã nguồn (dành cho lập trình viên)

Muốn build từ source, đóng góp code hoặc ghim bộ cài vào bản bạn clone:

Terminal
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai

# Same installer, run from the repo root
./install.sh

Lệnh cd đưa bạn vào thư mục vừa clone, và ./install.sh phải chạy từ đúng thư mục gốc đó. Muốn build image cục bộ từ source thì README nói phải đi đường này với ./install.sh --build. Cách cài một dòng ở trên luôn dùng image dựng sẵn.

E.Các tuỳ chọn của bộ cài

Bộ cài có bốn cờ do README liệt kê:

  • -y hoặc --yes: chấp nhận mọi mặc định, bỏ qua câu hỏi (hợp với CI).
  • --version TAG: ghim một phiên bản image, ví dụ --version 0.7.0.
  • --reconfigure: chạy lại trình hướng dẫn và ghi đè .env cũ.
  • --print-env-only: chỉ ghi .env và in ra lệnh compose, không khởi động container.

Ví dụ chạy bằng mặc định:

Terminal
./install.sh --yes

IV.Kiểm tra đã chạy được chưa

Khi trình cài kết thúc, nó tự chờ PipesHub khoẻ rồi in ra địa chỉ. Theo README, bạn mở http://localhost:3000 trong trình duyệt. Thấy giao diện PipesHub hiện ra là cài thành công.

Nếu bạn cài trên máy chủ đám mây và gặp màn hình trắng, README cho biết nguyên nhân thường gặp là truy cập bằng HTTP thường. Hãy đặt HTTPS phía trước (xem phần lỗi bên dưới).

Sau đó bạn vào phần Connectors, kết nối một nguồn dữ liệu, chờ lập chỉ mục xong rồi thử hỏi một câu. Câu trả lời đúng sẽ có trích dẫn về tài liệu gốc.

V.Dùng vào việc thật

A.Nhân viên mới tìm lại quyết định cũ

Bạn vào công ty được vài tuần, cần biết "vì sao team chọn cách tính phí này". Thông tin nằm rải ở một cuộc chat, một trang Confluence và một ticket Jira. Thay vì hỏi từng người, bạn kết nối ba nguồn đó vào PipesHub rồi gõ câu hỏi bằng tiếng thường. Kết quả là câu trả lời tổng hợp kèm trích dẫn đến từng nguồn, và bạn chỉ thấy những trang mà tài khoản của bạn có quyền xem.

Cùng một kho tri thức, mỗi người chỉ thấy phần mình được phép thấy.

Ông T

B.Lập trình viên hỏi từ Claude Code

Bạn muốn Claude Code, Cursor hoặc Codex trả lời dựa trên dữ liệu công ty. README mô tả quy trình khoảng mười phút sau khi PipesHub đã chạy và có dữ liệu: tạo Personal Access Token (không cần quyền admin), nối trợ lý của bạn (một lệnh cho Claude Code, một file cấu hình cho Cursor hoặc Codex). Rồi bạn hỏi như:

text
vì sao logic retry trong billing worker bị đổi?

Theo README, trợ lý sẽ trả lời từ báo cáo sự cố, pull request, cuộc trò chuyện và tài liệu thiết kế, mỗi nguồn có trích dẫn. Lệnh cụ thể nằm trong repo hướng dẫn riêng của PipesHub (pipeshub-ai/examples, thư mục company-knowledge-mcp), mình không chép lại ở đây để tránh sai.

Để tạo token, README ghi đường đi: workspace → Developer settings → Personal Access Tokens → New token, rồi chọn hạn dùng (30, 90, 365 ngày hoặc không giới hạn). Token chạy với tư cách chính bạn, nên kết quả tuân theo quyền của bạn.

C.Dùng bản Cloud, không cần tự cài

Nếu bạn không có máy chủ hay không muốn quản trị Docker, README cho biết có PipesHub Cloud với cùng connector, tìm kiếm có phân quyền và API. Các coding agent kết nối vào địa chỉ MCP sau bằng personal access token:

text
https://app.pipeshub.com/mcp

Bạn chỉ cần đăng ký, kết nối nguồn dữ liệu, tạo token và dán địa chỉ cùng token vào trợ lý của mình.

D.Nhúng vào sản phẩm của riêng bạn

Bạn là dev muốn thêm một ô tìm kiếm nội bộ cho team. PipesHub có SDK Python, TypeScript và Go (mỗi SDK là một repo riêng, xem README của repo đó để cài). Repo examples có sẵn mẫu khởi đầu cho SDK và ví dụ ô tìm kiếm. Kết quả là bạn có tìm kiếm theo quyền người dùng mà không phải tự dựng hệ thống lập chỉ mục.

VI.Lỗi hay gặp và cách xử lý

A.Màn hình trắng sau khi cài trên máy chủ

Đây là lỗi README nêu rõ: triển khai trên máy chủ đám mây mà chỉ dùng HTTP thì trình duyệt chặn một số yêu cầu. Cách xử lý là đặt HTTPS phía trước bằng Cloudflare, Nginx hoặc Traefik rồi truy cập qua địa chỉ HTTPS.

B.Lệnh docker báo không tìm thấy hoặc không kết nối được

Đa phần là Docker chưa được bật hoặc chưa cài bản có Compose v2. Mở ứng dụng Docker, chờ nó chạy ổn rồi chạy lại lệnh cài. Trình cài có bước kiểm tra Docker, RAM và đĩa nên nếu nó dừng, hãy đọc kỹ thông báo vì thường nó nói thẳng thiếu gì.

C.Muốn đổi cấu hình nhưng .env đã có sẵn

Chạy lại với cờ --reconfigure. Cờ này chạy lại trình hướng dẫn và ghi đè .env cũ, nên hãy sao lưu file cũ trước nếu bạn đã chỉnh tay.

Terminal
./install.sh --reconfigure

D.Hỏi mà không thấy dữ liệu hoặc thấy thiếu

Có hai nguyên nhân hay gặp. Một là nguồn mới kết nối, chưa lập chỉ mục xong. Hai là tài khoản của bạn không có quyền xem tài liệu đó ở hệ thống gốc, và PipesHub cố ý ẩn đi theo thiết kế. Chờ đồng bộ xong và kiểm tra quyền ở nguồn. Ngoài ra, âm thanh và video hiện chưa được lập chỉ mục.

E.Muốn chạy thử mà không khởi động container ngay

Dùng --print-env-only. Cờ này chỉ ghi .env và in ra lệnh compose để bạn xem, chưa chạy gì.

Terminal
./install.sh --print-env-only

VII.Có nên dùng không

Điểm mạnh. Mã nguồn mở Apache-2.0, tự host được, dùng model tuỳ chọn. Tìm kiếm có phân quyền và trích dẫn rõ ràng, đúng thứ doanh nghiệp cần. Cách cài một dòng khá thân thiện, và có cả MCP lẫn SDK để dựng thêm. Điểm số trên bài đo độc lập cũng rất ấn tượng.

Giới hạn. Đây là cả một hệ thống nhiều thành phần (ứng dụng web, backend, graph DB, message broker…), không phải một công cụ nhẹ chạy trong một phút. Bạn cần Docker và một máy đủ khoẻ. README không nói rõ Windows. Chất lượng câu trả lời còn phụ thuộc vào model bạn chọn và việc cấp quyền cho các connector. Âm thanh, video chưa được lập chỉ mục. Một số mục trong lộ trình như tìm kiếm cá nhân hoá vẫn chưa xong.

Khi nào chọn cách khác. Nếu bạn chỉ cần hỏi đáp trên vài file PDF của cá nhân, một công cụ nhỏ hơn sẽ đơn giản hơn nhiều. Nếu công ty bạn không có ai quản trị hạ tầng, hãy cân nhắc PipesHub Cloud thay vì tự cài. Còn nếu bạn có nhiều hệ thống nội bộ, quan tâm quyền truy cập và muốn đưa cùng một kho tri thức cho cả người lẫn AI agent, PipesHub rất đáng thử với một hai nguồn dữ liệu trước.

5.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

PipesHub có miễn phí không?

Mã nguồn mở theo giấy phép Apache-2.0, bạn tự cài và dùng được. Ngoài ra có bản PipesHub Cloud do đội phát triển vận hành. README không nêu giá của bản Cloud. Chi phí gọi model (LLM) tuỳ nhà cung cấp bạn chọn.

Cài PipesHub bằng cách nào nhanh nhất?

Có Docker kèm Compose v2 là chạy một lệnh: curl -fsSL https://get.pipeshub.com/install | bash. Lệnh này tải file triển khai vào thư mục ./pipeshub và mở trình cài tương tác. Xong thì mở http://localhost:3000.

PipesHub có chạy được trên Windows không?

README không nói rõ về Windows. Lệnh cài là script bash và yêu cầu Docker với Compose v2, nên bạn cần môi trường chạy được bash. Hãy xem thêm tài liệu chính thức của dự án trước khi cài.

Dữ liệu của tôi có an toàn không?

README nói PipesHub có thể tự host trong hạ tầng của bạn và dữ liệu không rời khỏi hạ tầng đó. Mỗi truy vấn được lọc theo quyền của người hỏi, đối chiếu với quyền ở hệ thống gốc. Nếu dùng model của bên thứ ba thì nội dung gửi cho model đó thế nào, README chưa có thông tin chi tiết.

PipesHub có cần GPU không?

Tư liệu không nhắc đến yêu cầu GPU. Trình cài chỉ nói là sẽ kiểm tra Docker, RAM và dung lượng ổ đĩa. Vì bạn có thể chọn nhà cung cấp LLM tuỳ ý, yêu cầu phần cứng còn phụ thuộc cách bạn chọn model.

Làm sao cho Claude Code hoặc Cursor dùng được dữ liệu của PipesHub?

Tạo Personal Access Token trong workspace (Developer settings → Personal Access Tokens → New token), rồi nối trợ lý qua MCP. Với bản Cloud, địa chỉ MCP là https://app.pipeshub.com/mcp. Hướng dẫn từng bước nằm trong repo examples của PipesHub.

PipesHub đọc được những loại file nào?

README ghi PDF (kể cả bản scan), Word, Excel, PowerPoint, Google Docs/Sheets/Slides, Markdown, HTML, CSV, văn bản thường và ảnh. Âm thanh và video có thể lưu trữ nhưng chưa được lập chỉ mục.

Chuyển nhanh tới mục

  1. I.PipesHub làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Docker
    2. B.Chạy lệnh cài một dòng
    3. C.Trả lời các câu hỏi của trình cài
    4. D.Cài từ mã nguồn (dành cho lập trình viên)
    5. E.Các tuỳ chọn của bộ cài
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhân viên mới tìm lại quyết định cũ
    2. B.Lập trình viên hỏi từ Claude Code
    3. C.Dùng bản Cloud, không cần tự cài
    4. D.Nhúng vào sản phẩm của riêng bạn
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Màn hình trắng sau khi cài trên máy chủ
    2. B.Lệnh docker báo không tìm thấy hoặc không kết nối được
    3. C.Muốn đổi cấu hình nhưng .env đã có sẵn
    4. D.Hỏi mà không thấy dữ liệu hoặc thấy thiếu
    5. E.Muốn chạy thử mà không khởi động container ngay
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.