<div align="center">

**Translations:** [English](../../../README.md) · [Français](../fr/README.md) · [Deutsch](../de/README.md) · [简体中文](../zh-CN/README.md) · [日本語](../ja/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](../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>Платформа корпоративного ИИ с открытым исходным кодом</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> — это ИИ-ориентированный слой выполнения с открытым исходным кодом и возможностью self-hosting, который связывает корпоративные знания, обеспечивает объяснимый поиск со ссылками на источники и автоматизирует рабочие процессы в ваших системах.


## Возможности

- 📝 **Объяснимые ответы:** PipesHub предоставляет обоснованные ответы с точными ссылками на конкретные блоки исходных документов.
- 🔒 **Поиск с учётом прав доступа:** Применяет контроль доступа на уровне источника, поэтому пользователи видят только то, к чему у них есть права.
- 🕸️ **Извлечение по графу знаний:** Извлечение на основе графа, фиксирующее связи между корпоративными данными.
- 🔌 **Корпоративные коннекторы:** Более 30 коннекторов с индексацией в реальном времени и по расписанию из коробки.
- 🔍 **Единый поиск, глубокие исследования и агенты:** Поиск, вопросы и ответы, глубокие исследования, веб-поиск и ИИ-агенты на одном контекстном слое.
- 📊 **Артефакты и выполнение кода:** Генерируйте отчёты, диаграммы и дашборды в безопасной песочнице выполнения.
- 🎙️ **Мультимодальная поддержка:** Понимание изображений, схем и отсканированных файлов, а также голосовое взаимодействие.
- 🤖 **No-code агенты и действия:** Создавайте агентов визуально и выполняйте действия в корпоративных инструментах.
- 🧠 **Используйте свою модель, полностью self-hosted:** Любой провайдер 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 | UI на App Router (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 (платформу корпоративного ИИ) можно запустить локально или развернуть в облаке с помощью Docker Compose.
**Примечание**: Если вы развёртываете PipesHub на облачном сервере, обязательно используйте HTTPS-эндпоинт. PipesHub применяет более строгие проверки безопасности, и браузеры будут блокировать некоторые запросы, когда приложение обслуживается по HTTP.
Вы можете использовать обратный прокси, например Cloudflare, Nginx или Traefik, чтобы терминировать SSL/TLS и предоставить действительный сертификат HTTPS.
Если после развёртывания PipesHub вы видите белый экран при доступе по HTTP, вероятнее всего, причина именно в этом. Фронтенд откажется загружаться из-за более строгих проверок безопасности.

---

### 📦 Развёртывание в продакшене

```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) в корне репозитория). Чтобы вместо этого использовать локальные теги, задайте `PYTHON_DEPS_IMAGE` и `RUNTIME_BASE_IMAGE` в окружении или в аргументах сборки compose.

## MCP-сервер

Используйте PipesHub с любым MCP-совместимым клиентом, чтобы привнести корпоративный контекст в рабочие процессы ИИ. Настройку и использование см. в README.

**Репозиторий:** [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/)

## SDK

PipesHub предоставляет SDK для разработчиков на Python, TypeScript и Go, чтобы помочь вам быстро выполнить интеграцию. Подробности по настройке и использованию см. в README соответствующего репозитория SDK.

| Название | Описание | Ссылка |
|------|-------------|------|
| **Python SDK** | Python SDK для PipesHub | [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python) |
| **TypeScript SDK** | TypeScript SDK для PipesHub | [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript) |
| **Go SDK** | Go SDK для PipesHub | [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go) |

> Нужен SDK на другом языке? Напишите нам на developer@pipeshub.com

## Дорожная карта

<p>Мы разрабатываем открыто. Вот что уже готово и что будет дальше:</p>

<ul>
<li>✅ 🤖 <strong>Корпоративные ИИ-агенты</strong>: первоклассный no-code конструктор агентов</li>
<li>✅ 🔗 Поддержка <strong>MCP (Model Context Protocol)</strong>, как сервера, так и клиента</li>
<li>✅ 🧰 <strong>SDK для разработчиков</strong></li>
<li>✅ 🔍 <strong>Поиск по коду</strong> в GitHub, GitLab и Bitbucket</li>
<li>⬜ 👤 <strong>Персонализированный поиск</strong> на основе команды, роли и истории</li>
<li>✅ ☸️ Развёртывание <strong>production 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 — это ИИ-ориентированный слой выполнения с открытым исходным кодом и возможностью self-hosting, который связывает корпоративные знания, обеспечивает объяснимый поиск со ссылками на источники и автоматизирует рабочие процессы в ваших системах. Он предоставляет единый контекстный слой для поиска, вопросов и ответов, глубоких исследований, веб-поиска и ИИ-агентов.

### Чем PipesHub отличается от других инструментов корпоративного ИИ?

PipesHub полностью открыт (Apache 2.0) и поддерживает self-hosting — ваши данные никогда не покидают вашу инфраструктуру. В нём есть поиск с учётом прав доступа, применяющий контроль доступа на уровне источника, и он предоставляет объяснимые ответы с точными ссылками на конкретные блоки исходных документов.

### Какие коннекторы поддерживает 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 может привести к блокировкам безопасности на фронтенде.

### Каких провайдеров LLM поддерживает PipesHub?

PipesHub работает по принципу «Используйте свою модель» — вы можете использовать любого провайдера LLM. Разверните в своём VPC предпочитаемые модели. Технологический стек включает LangChain и LangGraph для конвейеров и рабочих процессов LLM.

### Что такое функция извлечения по графу знаний?

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)

### Можно ли создавать ИИ-агентов без программирования?

Да. В PipesHub есть no-code конструктор агентов. Вы можете создавать агентов визуально и выполнять действия в корпоративных инструментах, не написав ни строки кода.

### Что такое мультимодальная поддержка?

PipesHub поддерживает понимание изображений, схем и отсканированных файлов, а также голосовое взаимодействие. Для разбора документов используются Docling и PyMuPDF, а для OCR отсканированных PDF — 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>Это помогает проекту дойти до команд, которым он нужен.</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>
