<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) · **한국어** · [Español](../es/README.md) · [Português](../pt/README.md) · [Türkçe](../tr/README.md) · [Tiếng Việt](../vi/README.md) · [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>오픈소스 업무용 AI 플랫폼</h3>

<p>
  <a href="https://www.pipeshub.com/">웹사이트</a> ·
  <a href="https://docs.pipeshub.com/">문서</a> ·
  <a href="https://discord.com/invite/K5RskzJBm2">Discord</a> ·
  <a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">로드맵</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 — 설명 가능하고 확장 가능한</h2>

<strong>[PipesHub](https://www.pipeshub.com/)</strong> 는 기업 지식을 연결하고, 인용이 포함된 설명 가능한 검색을 제공하며, 여러 시스템에 걸쳐 워크플로를 자동화하는 오픈소스이자 셀프 호스팅이 가능한 AI 네이티브 실행 계층입니다.


## 주요 기능

- 📝 **설명 가능한 답변:** PipesHub는 원본 문서의 정확한 블록 단위 인용과 함께 근거 있는 답변을 제공합니다.
- 🔒 **권한 인식 검색:** 소스 수준의 접근 제어를 적용하여 사용자는 권한이 있는 내용만 볼 수 있습니다.
- 🕸️ **지식 그래프 검색:** 기업 데이터 전반의 관계를 포착하는 그래프 기반 검색.
- 🔌 **엔터프라이즈 커넥터:** 실시간 및 예약 색인을 기본 제공하는 30개 이상의 커넥터.
- 🔍 **통합 검색, 심층 리서치, 에이전트:** 검색, Q&A, 심층 리서치, 웹 검색, AI 에이전트를 하나의 컨텍스트 계층에서 제공합니다.
- 📊 **아티팩트 및 코드 실행:** 안전한 실행 샌드박스에서 보고서, 차트, 대시보드를 생성합니다.
- 🎙️ **멀티모달 지원:** 이미지, 다이어그램, 스캔 파일 이해는 물론 음성 기반 상호작용도 지원합니다.
- 🤖 **노코드 에이전트와 액션:** 에이전트를 시각적으로 구축하고 기업 도구 전반에서 액션을 실행합니다.
- 🧠 **자체 모델 사용(BYOM), 완전한 셀프 호스팅:** 어떤 LLM 제공업체든 사용 가능하며, VPC에 배포되어 데이터가 인프라를 떠나지 않습니다.
- 🛠️ **개발자 우선, 확장 가능:** API, SDK, MCP 도구, 커스텀 커넥터, 독립적으로 확장 가능한 서비스.

## PipesHub 실제 동작

### 커넥터
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/Connector%20Setup%20and%20Query%20with%20Connectors.gif" alt="Connectors" width="100%"/>

### 인용
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/Citation%20through%20chat.gif" alt="Citations" width="100%"/>

### 모든 레코드
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/All%20Records%20Demo.gif" alt="All Records" width="100%"/>

### 지식 검색
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/Knowledge%20Search%20Demo.gif" alt="Knowledge Search" width="100%"/>

## 커넥터

<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>

## 지원 파일 형식

| 형식 | 세부 정보 |
|--------|---------|
| PDF | 스캔된 PDF 포함 |
| Docx / Doc | Microsoft Word |
| XLSX / XLS | Microsoft Excel |
| PPTX / PPT | Microsoft PowerPoint |
| CSV | 쉼표로 구분된 값 |
| Markdown | .md 파일 |
| HTML | 웹 페이지 |
| Text | 일반 텍스트 파일 |
| Google Docs, Sheets, Slides | Google Workspace 형식 |
| 이미지 | PNG, JPG 등 |
| 오디오 | 오디오 파일 |
| 비디오 | 비디오 파일 |

## 기술 스택

### 프런트엔드

| 기술 | 설명 |
|-----------|-------------|
| Next.js | App Router UI(클라이언트 렌더링 React) |
| TypeScript | 강타입 JavaScript 상위 집합 |
| Radix UI Themes | 접근성 있는 컴포넌트 프리미티브 및 스타일링 |
| Zod | 스키마 검증 및 파싱 |
| React Hook Form | 유연한 폼 상태 관리 |

### 백엔드

| 기술 | 설명 |
|-----------|-------------|
| FastAPI | 고성능 Python 웹 프레임워크 |
| LangChain | LLM 파이프라인용 프레임워크 |
| LangGraph | LLM 워크플로용 상태 그래프 |
| Qdrant | 벡터 유사도 검색 엔진 |
| Neo4j / ArangoDB | 그래프 데이터베이스 |
| Kafka / Redis Streams | 분산 이벤트 스트리밍 플랫폼 |
| Redis | 캐싱 |
| Redis / etcd3 | 분산 키-값 구성 저장소 |
| Celery | 분산 작업 큐 시스템 |
| Docling | 문서 파싱 및 추출 툴킷 |
| PyMuPDF | PDF 처리 라이브러리 |
| pandas | 데이터 분석 및 조작 |

## 🚀 배포 가이드

PipesHub(업무용 AI 플랫폼)는 로컬에서 실행하거나 Docker Compose를 사용하여 클라우드에 배포할 수 있습니다.
**참고**: PipesHub를 클라우드 서버에 배포하는 경우 반드시 HTTPS 엔드포인트를 사용하세요. PipesHub는 더 엄격한 보안 검사를 수행하므로, 애플리케이션이 HTTP로 제공될 때 브라우저는 일부 요청을 차단합니다.
Cloudflare, Nginx, Traefik 같은 리버스 프록시를 사용하여 SSL/TLS를 종료하고 유효한 HTTPS 인증서를 제공할 수 있습니다.
HTTP로 접속할 때 배포된 PipesHub에서 흰 화면이 보인다면, 이것이 원인일 가능성이 높습니다. 더 엄격한 보안 검사로 인해 프런트엔드가 로드를 거부합니다.

---

### 📦 프로덕션 배포

```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
```

### 📦 개발자 배포 빌드

```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`은 `pipeshubai/pipeshub-ai-base:python-deps`와 `pipeshubai/pipeshub-ai-base:runtime`에서 사전 빌드된 레이어를 가져옵니다(빌드/푸시 명령은 저장소 루트의 [`Dockerfile.base`](../../../Dockerfile.base) 참조). 대신 로컬 태그를 사용하려면 환경 변수 또는 compose 빌드 인자에서 `PYTHON_DEPS_IMAGE`와 `RUNTIME_BASE_IMAGE`를 설정하세요.

## MCP 서버

MCP 호환 클라이언트에서 PipesHub를 사용하여 기업 컨텍스트를 AI 워크플로로 가져오세요. 설정 및 사용법은 README를 확인하세요.

**저장소:** [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/)

## SDK

PipesHub는 빠른 통합을 돕기 위해 Python, TypeScript, Go용 개발자 SDK를 제공합니다. 설정 및 사용 세부 정보는 각 SDK 저장소의 README를 확인하세요.

| 이름 | 설명 | 링크 |
|------|-------------|------|
| **Python SDK** | PipesHub용 Python SDK | [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python) |
| **TypeScript SDK** | PipesHub용 TypeScript SDK | [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript) |
| **Go SDK** | PipesHub용 Go SDK | [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go) |

> 다른 언어의 SDK가 필요하신가요? developer@pipeshub.com 으로 문의해 주세요

## 로드맵

<p>우리는 공개적으로 개발합니다. 완료된 항목과 다음 계획은 다음과 같습니다:</p>

<ul>
<li>✅ 🤖 <strong>업무용 AI 에이전트</strong>: 최고 수준의 노코드 에이전트 빌더</li>
<li>✅ 🔗 <strong>MCP(Model Context Protocol)</strong> 지원, 서버와 클라이언트 모두</li>
<li>✅ 🧰 <strong>개발자 SDK</strong></li>
<li>✅ 🔍 GitHub, GitLab, Bitbucket 전반의 <strong>코드 검색</strong></li>
<li>⬜ 👤 팀, 역할, 이력 기반의 <strong>개인화 검색</strong></li>
<li>✅ ☸️ HA 기본값을 갖춘 <strong>프로덕션 Kubernetes</strong> 배포</li>
<li>⬜ 📈 지식 그래프 전반의 <strong>PageRank 강화 관련성</strong></li>
</ul>
<p>👉 <strong><a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Notion에서 전체 제품 로드맵 보기</a></strong></p>

<hr>

## 👥 기여하기

개발자 커뮤니티에 참여하고 싶으신가요? 개발 환경 설정 방법, 코딩 표준, 기여 워크플로에 대한 자세한 내용은 [기여 가이드](CONTRIBUTING.md)를 확인하세요.
<h3>무엇을 어디에서</h3>

<table>

<tr><td>질문하거나 도움 받기</td><td><a href="https://discord.com/invite/K5RskzJBm2">Discord</a></td></tr>
<tr><td>버그 신고 또는 기능 요청</td><td><a href="https://github.com/pipeshub-ai/pipeshub-ai/issues">GitHub Issues</a></td></tr>
<tr><td>보안 문제 신고</td><td><a href="SECURITY.md">보안 문제 신고</a></td></tr>
<tr><td>문서 읽기</td><td><a href="https://docs.pipeshub.com/">Pipeshub 문서</a></td></tr>
</tbody>
</table>

## 자주 묻는 질문

### PipesHub란 무엇인가요?

PipesHub는 기업 지식을 연결하고, 인용이 포함된 설명 가능한 검색을 제공하며, 여러 시스템에 걸쳐 워크플로를 자동화하는 오픈소스이자 셀프 호스팅이 가능한 AI 네이티브 실행 계층입니다. 검색, Q&A, 심층 리서치, 웹 검색, AI 에이전트를 위한 통합 컨텍스트 계층을 제공합니다.

### PipesHub는 다른 업무용 AI 도구와 어떻게 다른가요?

PipesHub는 완전한 오픈소스(Apache 2.0)이며 셀프 호스팅이 가능하여 데이터가 인프라를 떠나지 않습니다. 소스 수준의 접근 제어를 적용하는 권한 인식 검색을 제공하며, 원본 문서의 정확한 블록 단위 인용과 함께 설명 가능한 답변을 제공합니다.

### PipesHub는 어떤 커넥터를 지원하나요?

PipesHub는 실시간 및 예약 색인을 지원하는 30개 이상의 엔터프라이즈 커넥터를 갖추고 있습니다. PDF, Docx, XLSX, PPTX, CSV, Markdown, HTML, Google Docs/Sheets/Slides, 이미지, 오디오, 비디오 같은 파일 형식을 지원합니다.

### PipesHub는 어떻게 배포하나요?

```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
```

참고: 클라우드 배포에는 HTTPS를 사용하세요. HTTP는 프런트엔드 보안 차단을 유발할 수 있습니다.

### PipesHub는 어떤 LLM 제공업체를 지원하나요?

PipesHub는 "자체 모델 사용(Bring Your Own Model)" 방식으로, 어떤 LLM 제공업체든 사용할 수 있습니다. 원하는 모델을 VPC에 배포하세요. 기술 스택에는 LLM 파이프라인과 워크플로를 위한 LangChain과 LangGraph가 포함됩니다.

### 지식 그래프 검색 기능이란 무엇인가요?

PipesHub는 기업 데이터 전반의 관계를 포착하는 그래프 기반 검색을 사용합니다. 그래프 데이터베이스로 Neo4j 또는 ArangoDB를 사용하고, 벡터 유사도 검색을 위해 Qdrant와 결합합니다.

### PipesHub에 MCP 서버가 있나요?

네. PipesHub는 MCP 호환 클라이언트와의 통합을 위한 MCP 서버를 제공합니다. 저장소: [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/).

### 어떤 SDK를 사용할 수 있나요?

PipesHub는 다음 SDK를 제공합니다:
- **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)

### 코딩 없이 AI 에이전트를 구축할 수 있나요?

네. PipesHub에는 노코드 에이전트 빌더가 있습니다. 코드를 작성하지 않고도 에이전트를 시각적으로 구축하고 기업 도구 전반에서 액션을 실행할 수 있습니다.

### 멀티모달 지원이란 무엇인가요?

PipesHub는 이미지, 다이어그램, 스캔 파일 이해는 물론 음성 기반 상호작용을 지원합니다. 문서 파싱에는 Docling과 PyMuPDF를 사용하고, 스캔된 PDF의 OCR에는 Azure Document Intelligence 또는 멀티모달 LLM(VLM)을 사용합니다.

### 배포 문제는 어떻게 해결하나요?

1. 클라우드 배포에 HTTPS가 구성되어 있는지 확인하세요
2. Docker compose 로그를 확인하세요: `docker compose logs`
3. env.template의 환경 변수를 확인하세요
4. 자세한 가이드는 [docs.pipeshub.com](https://docs.pipeshub.com/)을 참조하세요

### 어디에서 도움을 받을 수 있나요?

- [Discord](https://discord.com/invite/K5RskzJBm2) — 질문하고 도움 받기
- [GitHub Issues](https://github.com/pipeshub-ai/pipeshub-ai/issues) — 버그 신고 또는 기능 요청
- [PipesHub 문서](https://docs.pipeshub.com/) — 문서 읽기


<hr>
<div align="center">
<h3>⭐ GitHub에서 별을 눌러주세요!</h3>

<p>이는 PipesHub가 필요한 팀에게 프로젝트가 닿도록 도와줍니다.</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><a href="https://www.pipeshub.com/">PipesHub 팀</a>과 전 세계 기여자들이 ❤️ 로 만들었습니다.</sub></p>

</div>
