<div align="center">

**Translations:** [English](../../../README.md) · [Français](../fr/README.md) · [Deutsch](../de/README.md) · [简体中文](../zh-CN/README.md) · [日本語](../ja/README.md) · [Русский](../ru/README.md) · [עברית](../he/README.md) · [한국어](../ko/README.md) · [Español](../es/README.md) · [Português](../pt/README.md) · [Türkçe](../tr/README.md) · **Tiếng Việt** · [Italiano](../it/README.md)

</div>

<div align="center">

<a href="https://www.pipeshub.com"><img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/refs/heads/main/images/pipeshub-logo.svg" alt="PipesHub" width="280"/></a>

<h3>Nền tảng AI cho nơi làm việc, mã nguồn mở</h3>

<p>
  <a href="https://www.pipeshub.com/">Trang web</a> ·
  <a href="https://docs.pipeshub.com/">Tài liệu</a> ·
  <a href="https://discord.com/invite/K5RskzJBm2">Discord</a> ·
  <a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Lộ trình</a>
</p>

<a href="https://trendshift.io/repositories/14618"><img src="https://trendshift.io/api/badge/repositories/14618" alt="PipesHub on Trendshift" height="40"/></a>

<p>
  <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a>
  <a href="https://github.com/pipeshub-ai/pipeshub-ai/releases"><img src="https://img.shields.io/github/v/release/pipeshub-ai/pipeshub-ai?color=success&amp;label=release" alt="Release"></a>
  <a href="https://hub.docker.com/r/pipeshubai/pipeshub-ai"><img src="https://img.shields.io/docker/pulls/pipeshubai/pipeshub-ai?logo=docker&amp;logoColor=white" alt="Docker Pulls"></a>
  <a href="https://discord.com/invite/K5RskzJBm2"><img src="https://img.shields.io/discord/1359557598222745670?label=Discord&amp;logo=discord&amp;logoColor=white" alt="Discord"></a>
  <img src="https://img.shields.io/github/last-commit/pipeshub-ai/pipeshub-ai" alt="Last commit">
  <img src="https://img.shields.io/github/commit-activity/m/pipeshub-ai/pipeshub-ai" alt="Commits per month">
  <a href="https://github.com/pipeshub-ai/pipeshub-ai/issues">
    <img src="https://img.shields.io/github/issues/pipeshub-ai/pipeshub-ai" alt="GitHub issues">
  </a>
  <a href="https://github.com/pipeshub-ai/pipeshub-ai/pulls">
    <img src="https://img.shields.io/github/issues-pr/pipeshub-ai/pipeshub-ai" alt="GitHub pull requests">
  </a>
  <a href="https://github.com/pipeshub-ai/pipeshub-ai/stargazers">
    <img src="https://img.shields.io/github/stars/pipeshub-ai/pipeshub-ai" alt="GitHub Repo stars">
  </a>
  <br/>
  <a href="https://x.com/PipesHub"><img src="https://img.shields.io/twitter/follow/PipesHub?style=social" alt="Twitter"></a>
  <a href="https://www.linkedin.com/company/pipeshub"><img src="https://img.shields.io/badge/LinkedIn-PipesHub-blue?logo=linkedin&amp;logoColor=white" alt="LinkedIn"></a>
  <br/>
  <img src="https://img.shields.io/badge/-d0d0d0?style=flat" width="40%" height="1" alt="" />
  <br/>
  <a href="https://www.npmjs.com/package/@pipeshub-ai/sdk"><img src="https://img.shields.io/npm/v/@pipeshub-ai/sdk?logo=npm&amp;logoColor=white&amp;label=node%20sdk" alt="Node.js SDK" /></a>
  <a href="https://pypi.org/project/pipeshub-sdk/"><img src="https://img.shields.io/pypi/v/pipeshub-sdk?logo=python&amp;logoColor=white&amp;label=python%20sdk" alt="Python SDK" /></a>
  <a href="https://github.com/pipeshub-ai/pipeshub-sdk-go"><img src="https://img.shields.io/github/v/release/pipeshub-ai/pipeshub-sdk-go?logo=go&amp;logoColor=white&amp;label=go%20sdk" alt="Go SDK" /></a>
  <a href="https://www.npmjs.com/package/pipeshub"><img src="https://img.shields.io/npm/v/pipeshub?logo=npm&amp;logoColor=white&amp;label=mcp" alt="MCP" /></a>
</p>

</div>

<h2 id="about-pipeshub">PipesHub — Có thể giải thích & Có thể mở rộng</h2>

<strong>[PipesHub](https://www.pipeshub.com/)</strong> là một lớp thực thi gốc AI, mã nguồn mở và có thể tự lưu trữ, kết nối tri thức doanh nghiệp, cung cấp tìm kiếm có thể giải thích kèm trích dẫn và tự động hóa quy trình làm việc trên khắp các hệ thống của bạn.


## Tính năng

- 📝 **Câu trả lời có thể giải thích:** PipesHub đưa ra các câu trả lời có căn cứ kèm trích dẫn chính xác đến từng khối trong tài liệu gốc.
- 🔒 **Tìm kiếm nhận biết quyền truy cập:** Thực thi kiểm soát truy cập ở cấp nguồn để người dùng chỉ thấy những gì họ được phép.
- 🕸️ **Truy xuất bằng đồ thị tri thức:** Truy xuất dựa trên đồ thị, nắm bắt các mối quan hệ giữa dữ liệu doanh nghiệp.
- 🔌 **Trình kết nối doanh nghiệp:** Hơn 30 trình kết nối với lập chỉ mục thời gian thực và theo lịch, sẵn sàng dùng ngay.
- 🔍 **Tìm kiếm hợp nhất, Nghiên cứu sâu và Tác nhân:** Tìm kiếm, hỏi đáp, nghiên cứu sâu, tìm kiếm web và các tác nhân AI trên cùng một lớp ngữ cảnh.
- 📊 **Tạo tác phẩm và Thực thi mã:** Tạo báo cáo, biểu đồ và bảng điều khiển trong một hộp cát thực thi an toàn.
- 🎙️ **Hỗ trợ đa phương thức:** Hiểu hình ảnh, sơ đồ và tệp quét, cùng với tương tác bằng giọng nói.
- 🤖 **Tác nhân và Hành động không cần mã:** Xây dựng tác nhân một cách trực quan và thực thi hành động trên các công cụ doanh nghiệp.
- 🧠 **Mang mô hình của riêng bạn, hoàn toàn tự lưu trữ:** Bất kỳ nhà cung cấp LLM nào, triển khai trong VPC của bạn — dữ liệu không bao giờ rời khỏi hạ tầng của bạn.
- 🛠️ **Ưu tiên nhà phát triển và có thể mở rộng:** API, SDK, công cụ MCP, trình kết nối tùy chỉnh và các dịch vụ có thể mở rộng độc lập.

## PipesHub trong thực tế

### Trình kết nối
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/Connector%20Setup%20and%20Query%20with%20Connectors.gif" alt="Connectors" width="100%"/>

### Trích dẫn
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/Citation%20through%20chat.gif" alt="Citations" width="100%"/>

### Tất cả bản ghi
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/All%20Records%20Demo.gif" alt="All Records" width="100%"/>

### Tìm kiếm tri thức
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/Knowledge%20Search%20Demo.gif" alt="Knowledge Search" width="100%"/>

## Trình kết nối

<p align="center">
<a href="https://pipeshub.com/connectors"><img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/images/Github%20Connector%20Readme.png" alt="PipesHub Connectors" width="900"/></a>
</p>

## Các định dạng tệp được hỗ trợ

| Định dạng | Chi tiết |
|--------|---------|
| PDF | Bao gồm cả PDF đã quét |
| Docx / Doc | Microsoft Word |
| XLSX / XLS | Microsoft Excel |
| PPTX / PPT | Microsoft PowerPoint |
| CSV | Giá trị phân tách bằng dấu phẩy |
| Markdown | Tệp .md |
| HTML | Trang web |
| Text | Tệp văn bản thuần |
| Google Docs, Sheets, Slides | Định dạng Google Workspace |
| Hình ảnh | PNG, JPG, v.v. |
| Âm thanh | Tệp âm thanh |
| Video | Tệp video |

## Ngăn xếp công nghệ

### Frontend

| Công nghệ | Mô tả |
|-----------|-------------|
| Next.js | Giao diện App Router (React kết xuất phía client) |
| TypeScript | Tập cha của JavaScript với kiểu mạnh |
| Radix UI Themes | Các thành phần nguyên thủy dễ truy cập và tạo kiểu |
| Zod | Xác thực và phân tích lược đồ |
| React Hook Form | Quản lý trạng thái biểu mẫu linh hoạt |

### Backend

| Công nghệ | Mô tả |
|-----------|-------------|
| FastAPI | Khung web Python hiệu năng cao |
| LangChain | Khung cho các pipeline LLM |
| LangGraph | Đồ thị trạng thái cho các quy trình LLM |
| Qdrant | Công cụ tìm kiếm theo độ tương đồng vectơ |
| Neo4j / ArangoDB | Cơ sở dữ liệu đồ thị |
| Kafka / Redis Streams | Nền tảng truyền sự kiện phân tán |
| Redis | Bộ nhớ đệm |
| Redis / etcd3 | Kho cấu hình khóa-giá trị phân tán |
| Celery | Hệ thống hàng đợi tác vụ phân tán |
| Docling | Bộ công cụ phân tích và trích xuất tài liệu |
| PyMuPDF | Thư viện xử lý PDF |
| pandas | Phân tích và xử lý dữ liệu |

## 🚀 Hướng dẫn triển khai

PipesHub (Nền tảng AI cho nơi làm việc) có thể chạy cục bộ hoặc triển khai trên đám mây bằng Docker Compose.
**Lưu ý**: Nếu bạn triển khai PipesHub trên máy chủ đám mây, hãy đảm bảo sử dụng điểm cuối HTTPS. PipesHub thực thi các kiểm tra bảo mật chặt chẽ hơn, và trình duyệt sẽ chặn một số yêu cầu khi ứng dụng được phục vụ qua HTTP.
Bạn có thể dùng một reverse proxy như Cloudflare, Nginx hoặc Traefik để kết thúc SSL/TLS và cung cấp chứng chỉ HTTPS hợp lệ.
Nếu bạn thấy màn hình trắng sau khi triển khai PipesHub khi truy cập qua HTTP, đây rất có thể là nguyên nhân. Frontend sẽ từ chối tải do các kiểm tra bảo mật chặt chẽ hơn.

---

### 📦 Triển khai sản xuất

```bash
# Clone the repository
git clone https://github.com/pipeshub-ai/pipeshub-ai.git

# 📁 Navigate to the deployment folder
cd pipeshub-ai/deployment/docker-compose

# Set Environment Variables
> 👉 Set Environment Variables for secrets, passwords, and the public URLs of the **Frontend** and **Connector** services
> _(Required for webhook notifications and real-time updates)_
> Refer to env.template

# 🚀 Start the production deployment
docker compose -f docker-compose.prod.yml -p pipeshub-ai up -d

# 🛑 To stop the services
docker compose -f docker-compose.prod.yml -p pipeshub-ai down
```

### 📦 Bản dựng triển khai cho nhà phát triển

```bash
# Clone the repository
git clone https://github.com/pipeshub-ai/pipeshub-ai.git

# 📁 Navigate to the deployment folder
cd pipeshub-ai/deployment/docker-compose

# Set Optional Environment Variables
> 👉 Set Environment Variables for secrets, passwords, and the public URLs of the **Frontend** and **Connector** services
> _(Required for webhook notifications and real-time updates)_
> Refer to env.template

# 🚀 Start the local build deployment
docker compose -f docker-compose.build.neo4j.yml -p pipeshub-ai up --build -d

# 🛑 To stop the services
docker compose -f docker-compose.build.neo4j.yml -p pipeshub-ai down
```

`Dockerfile` chính kéo các lớp dựng sẵn từ `pipeshubai/pipeshub-ai-base:python-deps` và `pipeshubai/pipeshub-ai-base:runtime` (xem [`Dockerfile.base`](../../../Dockerfile.base) ở thư mục gốc của kho lưu trữ để biết lệnh build/push). Để dùng thẻ cục bộ thay thế, hãy đặt `PYTHON_DEPS_IMAGE` và `RUNTIME_BASE_IMAGE` trong môi trường hoặc trong tham số build của compose.

## Máy chủ MCP

Sử dụng PipesHub với bất kỳ client tương thích MCP nào để đưa ngữ cảnh doanh nghiệp của bạn vào các quy trình AI. Xem README để biết cách thiết lập và sử dụng.

**Kho lưu trữ:** [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/)

## SDK

PipesHub cung cấp các SDK dành cho nhà phát triển bằng Python, TypeScript và Go để giúp bạn tích hợp nhanh chóng. Xem README của kho SDK tương ứng để biết chi tiết thiết lập và sử dụng.

| Tên | Mô tả | Liên kết |
|------|-------------|------|
| **Python SDK** | SDK Python cho PipesHub | [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python) |
| **TypeScript SDK** | SDK TypeScript cho PipesHub | [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript) |
| **Go SDK** | SDK Go cho PipesHub | [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go) |

> Cần SDK bằng ngôn ngữ khác? Hãy liên hệ với chúng tôi qua developer@pipeshub.com

## Lộ trình

<p>Chúng tôi phát triển một cách công khai. Đây là những gì đã hoàn thành và sắp tới:</p>

<ul>
<li>✅ 🤖 <strong>Tác nhân AI cho nơi làm việc</strong>: trình tạo tác nhân không cần mã hàng đầu</li>
<li>✅ 🔗 Hỗ trợ <strong>MCP (Model Context Protocol)</strong>, cả máy chủ lẫn client</li>
<li>✅ 🧰 <strong>SDK cho nhà phát triển</strong></li>
<li>✅ 🔍 <strong>Tìm kiếm mã</strong> trên GitHub, GitLab và Bitbucket</li>
<li>⬜ 👤 <strong>Tìm kiếm cá nhân hóa</strong> dựa trên nhóm, vai trò và lịch sử</li>
<li>✅ ☸️ Triển khai <strong>Kubernetes cho sản xuất</strong> với mặc định sẵn sàng cao (HA)</li>
<li>⬜ 📈 <strong>Mức độ liên quan tăng cường bằng PageRank</strong> trên toàn đồ thị tri thức</li>
</ul>
<p>👉 <strong><a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Xem lộ trình sản phẩm đầy đủ trên Notion</a></strong></p>

<hr>

## 👥 Đóng góp

Bạn muốn tham gia cộng đồng nhà phát triển của chúng tôi? Vui lòng xem [Hướng dẫn đóng góp](CONTRIBUTING.md) của chúng tôi để biết thêm chi tiết về cách thiết lập môi trường phát triển, các tiêu chuẩn lập trình và quy trình đóng góp.
<h3>Cần gì thì đến đâu</h3>

<table>

<tr><td>Đặt câu hỏi hoặc nhận trợ giúp</td><td><a href="https://discord.com/invite/K5RskzJBm2">Discord</a></td></tr>
<tr><td>Báo lỗi hoặc yêu cầu tính năng</td><td><a href="https://github.com/pipeshub-ai/pipeshub-ai/issues">GitHub Issues</a></td></tr>
<tr><td>Báo cáo vấn đề bảo mật</td><td><a href="SECURITY.md">Báo cáo vấn đề bảo mật</a></td></tr>
<tr><td>Đọc tài liệu</td><td><a href="https://docs.pipeshub.com/">Tài liệu Pipeshub</a></td></tr>
</tbody>
</table>

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

### PipesHub là gì?

PipesHub là một lớp thực thi gốc AI, mã nguồn mở và có thể tự lưu trữ, kết nối tri thức doanh nghiệp, cung cấp tìm kiếm có thể giải thích kèm trích dẫn và tự động hóa quy trình làm việc trên khắp các hệ thống của bạn. Nó cung cấp một lớp ngữ cảnh hợp nhất cho tìm kiếm, hỏi đáp, nghiên cứu sâu, tìm kiếm web và các tác nhân AI.

### PipesHub khác với các công cụ AI cho nơi làm việc khác như thế nào?

PipesHub hoàn toàn mã nguồn mở (Apache 2.0) và có thể tự lưu trữ — dữ liệu của bạn không bao giờ rời khỏi hạ tầng của bạn. Nó có tính năng tìm kiếm nhận biết quyền truy cập, thực thi kiểm soát truy cập ở cấp nguồn, và đưa ra các câu trả lời có thể giải thích kèm trích dẫn chính xác đến từng khối trong tài liệu gốc.

### PipesHub hỗ trợ những trình kết nối nào?

PipesHub có hơn 30 trình kết nối doanh nghiệp với lập chỉ mục thời gian thực và theo lịch. Nó hỗ trợ các định dạng tệp như PDF, Docx, XLSX, PPTX, CSV, Markdown, HTML, Google Docs/Sheets/Slides, hình ảnh, âm thanh và video.

### Tôi triển khai PipesHub như thế nào?

```bash
# Clone the repository
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai/deployment/docker-compose

# Set Environment Variables (refer to env.template)
# Start production deployment
docker compose -f docker-compose.prod.yml -p pipeshub-ai up -d
```

Lưu ý: Hãy dùng HTTPS cho việc triển khai trên đám mây. HTTP có thể gây ra việc chặn bảo mật ở frontend.

### PipesHub hỗ trợ những nhà cung cấp LLM nào?

PipesHub theo nguyên tắc "Mang mô hình của riêng bạn" — bạn có thể dùng bất kỳ nhà cung cấp LLM nào. Triển khai trong VPC của bạn với các mô hình bạn ưa thích. Ngăn xếp công nghệ bao gồm LangChain và LangGraph cho các pipeline và quy trình LLM.

### Tính năng truy xuất bằng đồ thị tri thức là gì?

PipesHub sử dụng truy xuất dựa trên đồ thị để nắm bắt các mối quan hệ giữa dữ liệu doanh nghiệp. Nó dùng Neo4j hoặc ArangoDB làm cơ sở dữ liệu đồ thị, kết hợp với Qdrant để tìm kiếm theo độ tương đồng vectơ.

### PipesHub có máy chủ MCP không?

Có. PipesHub cung cấp một máy chủ MCP để tích hợp với bất kỳ client tương thích MCP nào. Kho lưu trữ: [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/).

### Có những SDK nào?

PipesHub cung cấp SDK cho:
- **Python**: [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python)
- **TypeScript**: [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript)
- **Go**: [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go)

### Tôi có thể xây dựng tác nhân AI mà không cần lập trình không?

Có. PipesHub có một trình tạo tác nhân không cần mã. Bạn có thể xây dựng tác nhân một cách trực quan và thực thi hành động trên các công cụ doanh nghiệp mà không cần viết mã.

### Hỗ trợ đa phương thức là gì?

PipesHub hỗ trợ hiểu hình ảnh, sơ đồ và tệp quét, cùng với tương tác bằng giọng nói. Nó dùng Docling và PyMuPDF để phân tích tài liệu, và Azure Document Intelligence hoặc một LLM đa phương thức (VLM) để OCR các PDF đã quét.

### Tôi khắc phục sự cố triển khai như thế nào?

1. Đảm bảo HTTPS được cấu hình cho việc triển khai trên đám mây
2. Kiểm tra nhật ký Docker compose: `docker compose logs`
3. Xác minh các biến môi trường trong env.template
4. Tham khảo [docs.pipeshub.com](https://docs.pipeshub.com/) để có hướng dẫn chi tiết

### Tôi có thể nhận trợ giúp ở đâu?

- [Discord](https://discord.com/invite/K5RskzJBm2) — Đặt câu hỏi và nhận trợ giúp
- [GitHub Issues](https://github.com/pipeshub-ai/pipeshub-ai/issues) — Báo lỗi hoặc yêu cầu tính năng
- [Tài liệu PipesHub](https://docs.pipeshub.com/) — Đọc tài liệu


<hr>
<div align="center">
<h3>⭐ Hãy gắn sao cho chúng tôi trên GitHub!</h3>

<p>Điều đó giúp dự án đến được với các nhóm cần nó.</p>

<p>
<a href="https://github.com/pipeshub-ai/pipeshub-ai">
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/refs/heads/main/gif/pipeshub.gif" alt="Star PipesHub" width="350"/>
</a>
</p>

<p>
<a href="https://star-history.com/#pipeshub-ai/pipeshub-ai&amp;Date">
<img src="https://api.star-history.com/svg?repos=pipeshub-ai/pipeshub-ai&amp;type=Date" alt="Star History" width="600"/>
</a>
</p>

<p><sub>Được xây dựng với ❤️ bởi <a href="https://www.pipeshub.com/">đội ngũ PipesHub</a> và những người đóng góp trên khắp thế giới.</sub></p>

</div>
