<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** · [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>A plataforma de IA para o trabalho, de código aberto</h3>

<p>
  <a href="https://www.pipeshub.com/">Site</a> ·
  <a href="https://docs.pipeshub.com/">Documentação</a> ·
  <a href="https://discord.com/invite/K5RskzJBm2">Discord</a> ·
  <a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Roadmap</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 — Explicável e Extensível</h2>

<strong>[PipesHub](https://www.pipeshub.com/)</strong> é uma camada de execução nativa de IA, de código aberto e auto-hospedável, que conecta o conhecimento corporativo, oferece busca explicável com citações e automatiza fluxos de trabalho em todos os seus sistemas.


## Funcionalidades

- 📝 **Respostas explicáveis:** O PipesHub entrega respostas fundamentadas com citações precisas de blocos aos documentos originais.
- 🔒 **Busca com reconhecimento de permissões:** Aplica controles de acesso no nível da fonte para que os usuários vejam apenas o que têm autorização.
- 🕸️ **Recuperação por grafo de conhecimento:** Recuperação baseada em grafos que captura as relações entre os dados corporativos.
- 🔌 **Conectores corporativos:** Mais de 30 conectores com indexação em tempo real e agendada, prontos para uso.
- 🔍 **Busca unificada, pesquisa aprofundada e agentes:** Busca, perguntas e respostas, pesquisa aprofundada, busca na web e agentes de IA sobre uma única camada de contexto.
- 📊 **Artefatos e execução de código:** Gere relatórios, gráficos e painéis em um sandbox de execução seguro.
- 🎙️ **Suporte multimodal:** Compreensão de imagens, diagramas e arquivos digitalizados, além de interação por voz.
- 🤖 **Agentes e ações sem código:** Crie agentes visualmente e execute ações nas ferramentas corporativas.
- 🧠 **Use seu próprio modelo, totalmente auto-hospedável:** Qualquer provedor de LLM, implantado na sua VPC — os dados nunca saem da sua infraestrutura.
- 🛠️ **Voltado a desenvolvedores e extensível:** APIs, SDKs, ferramentas MCP, conectores personalizados e serviços escaláveis de forma independente.

## PipesHub em ação

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

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

### Todos os registros
<img src="https://raw.githubusercontent.com/pipeshub-ai/media-assets/main/gif/All%20Records%20Demo.gif" alt="All Records" width="100%"/>

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

## Conectores

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

## Formatos de arquivo suportados

| Formato | Detalhes |
|--------|---------|
| PDF | Incluindo PDFs digitalizados |
| Docx / Doc | Microsoft Word |
| XLSX / XLS | Microsoft Excel |
| PPTX / PPT | Microsoft PowerPoint |
| CSV | Valores separados por vírgula |
| Markdown | Arquivos .md |
| HTML | Páginas web |
| Text | Arquivos de texto simples |
| Google Docs, Sheets, Slides | Formatos do Google Workspace |
| Imagens | PNG, JPG, etc. |
| Áudio | Arquivos de áudio |
| Vídeo | Arquivos de vídeo |

## Stack tecnológico

### Frontend

| Tecnologia | Descrição |
|-----------|-------------|
| Next.js | UI com App Router (React renderizado no cliente) |
| TypeScript | Superconjunto de JavaScript com tipagem forte |
| Radix UI Themes | Primitivos de componentes acessíveis e estilização |
| Zod | Validação e análise de esquemas |
| React Hook Form | Gerenciamento flexível de estado de formulários |

### Backend

| Tecnologia | Descrição |
|-----------|-------------|
| FastAPI | Framework web Python de alto desempenho |
| LangChain | Framework para pipelines de LLM |
| LangGraph | Grafo de estados para fluxos de trabalho de LLM |
| Qdrant | Mecanismo de busca por similaridade vetorial |
| Neo4j / ArangoDB | Banco de dados de grafos |
| Kafka / Redis Streams | Plataforma distribuída de streaming de eventos |
| Redis | Cache |
| Redis / etcd3 | Armazenamento de configuração chave-valor distribuído |
| Celery | Sistema de filas de tarefas distribuídas |
| Docling | Kit de ferramentas de análise e extração de documentos |
| PyMuPDF | Biblioteca de processamento de PDF |
| pandas | Análise e manipulação de dados |

## 🚀 Guia de implantação

O PipesHub (a plataforma de IA para o trabalho) pode ser executado localmente ou implantado na nuvem usando o Docker Compose.
**Observação**: Se você for implantar o PipesHub em um servidor na nuvem, certifique-se de usar um endpoint HTTPS. O PipesHub aplica verificações de segurança mais rígidas, e os navegadores bloquearão certas requisições quando a aplicação for servida por HTTP.
Você pode usar um proxy reverso como Cloudflare, Nginx ou Traefik para terminar o SSL/TLS e fornecer um certificado HTTPS válido.
Se você vir uma tela branca após implantar o PipesHub ao acessá-lo por HTTP, esta é provavelmente a causa. O frontend se recusará a carregar devido às verificações de segurança mais rígidas.

---

### 📦 Implantação em produção

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

### 📦 Build de implantação para desenvolvedores

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

O `Dockerfile` principal obtém camadas pré-construídas de `pipeshubai/pipeshub-ai-base:python-deps` e `pipeshubai/pipeshub-ai-base:runtime` (consulte [`Dockerfile.base`](../../../Dockerfile.base) na raiz do repositório para os comandos de build/push). Para usar tags locais em vez disso, defina `PYTHON_DEPS_IMAGE` e `RUNTIME_BASE_IMAGE` no ambiente ou nos argumentos de build do compose.

## Servidor MCP

Use o PipesHub com qualquer cliente compatível com MCP para trazer o contexto da sua empresa para os fluxos de trabalho de IA. Consulte o README para configuração e uso.

**Repositório:** [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/)

## SDKs

O PipesHub oferece SDKs para desenvolvedores em Python, TypeScript e Go para ajudar você a integrar rapidamente. Consulte o README do repositório do respectivo SDK para detalhes de configuração e uso.

| Nome | Descrição | Link |
|------|-------------|------|
| **Python SDK** | SDK de Python para o PipesHub | [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python) |
| **TypeScript SDK** | SDK de TypeScript para o PipesHub | [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript) |
| **Go SDK** | SDK de Go para o PipesHub | [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go) |

> Precisa de um SDK em outra linguagem? Fale conosco em developer@pipeshub.com

## Roadmap

<p>Desenvolvemos de forma aberta. Veja o que já está pronto e o que vem a seguir:</p>

<ul>
<li>✅ 🤖 <strong>Agentes de IA para o trabalho</strong>: construtor de agentes sem código de primeira classe</li>
<li>✅ 🔗 Suporte a <strong>MCP (Model Context Protocol)</strong>, tanto servidor quanto cliente</li>
<li>✅ 🧰 <strong>SDKs para desenvolvedores</strong></li>
<li>✅ 🔍 <strong>Busca de código</strong> no GitHub, GitLab e Bitbucket</li>
<li>⬜ 👤 <strong>Busca personalizada</strong> com base em equipe, função e histórico</li>
<li>✅ ☸️ Implantação em <strong>Kubernetes para produção</strong> com padrões de alta disponibilidade</li>
<li>⬜ 📈 <strong>Relevância aprimorada por PageRank</strong> em todo o grafo de conhecimento</li>
</ul>
<p>👉 <strong><a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Veja o roadmap completo do produto no Notion</a></strong></p>

<hr>

## 👥 Contribuindo

Quer fazer parte da nossa comunidade de desenvolvedores? Confira nosso [Guia de Contribuição](CONTRIBUTING.md) para mais detalhes sobre como configurar o ambiente de desenvolvimento, nossos padrões de código e o fluxo de trabalho de contribuição.
<h3>Onde ir para cada coisa</h3>

<table>

<tr><td>Fazer uma pergunta ou obter ajuda</td><td><a href="https://discord.com/invite/K5RskzJBm2">Discord</a></td></tr>
<tr><td>Relatar um bug ou solicitar um recurso</td><td><a href="https://github.com/pipeshub-ai/pipeshub-ai/issues">GitHub Issues</a></td></tr>
<tr><td>Relatar um problema de segurança</td><td><a href="SECURITY.md">Relatar problema de segurança</a></td></tr>
<tr><td>Ler a documentação</td><td><a href="https://docs.pipeshub.com/">Documentação do Pipeshub</a></td></tr>
</tbody>
</table>

## Perguntas frequentes

### O que é o PipesHub?

O PipesHub é uma camada de execução nativa de IA, de código aberto e auto-hospedável, que conecta o conhecimento corporativo, oferece busca explicável com citações e automatiza fluxos de trabalho em todos os seus sistemas. Ele fornece uma camada de contexto unificada para busca, perguntas e respostas, pesquisa aprofundada, busca na web e agentes de IA.

### Como o PipesHub se diferencia de outras ferramentas de IA para o trabalho?

O PipesHub é totalmente de código aberto (Apache 2.0) e auto-hospedável — seus dados nunca saem da sua infraestrutura. Ele conta com busca com reconhecimento de permissões que aplica controles de acesso no nível da fonte e entrega respostas explicáveis com citações precisas de blocos aos documentos originais.

### Quais conectores o PipesHub suporta?

O PipesHub possui mais de 30 conectores corporativos com indexação em tempo real e agendada. Ele suporta formatos de arquivo como PDF, Docx, XLSX, PPTX, CSV, Markdown, HTML, Google Docs/Sheets/Slides, imagens, áudio e vídeo.

### Como eu implanto o 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
```

Observação: Use HTTPS para implantações na nuvem. O HTTP pode causar bloqueios de segurança no frontend.

### Quais provedores de LLM o PipesHub suporta?

O PipesHub é "Use seu próprio modelo" — você pode usar qualquer provedor de LLM. Implante na sua VPC com os modelos de sua preferência. O stack tecnológico inclui LangChain e LangGraph para pipelines e fluxos de trabalho de LLM.

### O que é o recurso de recuperação por grafo de conhecimento?

O PipesHub usa recuperação baseada em grafos que captura as relações entre os dados corporativos. Ele usa Neo4j ou ArangoDB como bancos de dados de grafos, combinados com o Qdrant para busca por similaridade vetorial.

### O PipesHub tem um servidor MCP?

Sim. O PipesHub oferece um servidor MCP para integração com qualquer cliente compatível com MCP. Repositório: [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/).

### Quais SDKs estão disponíveis?

O PipesHub oferece SDKs para:
- **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)

### Posso criar agentes de IA sem programar?

Sim. O PipesHub tem um construtor de agentes sem código. Você pode criar agentes visualmente e executar ações nas ferramentas corporativas sem escrever código.

### O que é o suporte multimodal?

O PipesHub suporta a compreensão de imagens, diagramas e arquivos digitalizados, além da interação por voz. Ele usa Docling e PyMuPDF para análise de documentos, e Azure Document Intelligence ou um LLM multimodal (VLM) para o OCR de PDFs digitalizados.

### Como soluciono problemas de implantação?

1. Certifique-se de que o HTTPS está configurado para implantações na nuvem
2. Verifique os logs do Docker compose: `docker compose logs`
3. Confira as variáveis de ambiente em env.template
4. Consulte [docs.pipeshub.com](https://docs.pipeshub.com/) para guias detalhados

### Onde posso obter ajuda?

- [Discord](https://discord.com/invite/K5RskzJBm2) — Faça perguntas e obtenha ajuda
- [GitHub Issues](https://github.com/pipeshub-ai/pipeshub-ai/issues) — Relate bugs ou solicite recursos
- [Documentação do PipesHub](https://docs.pipeshub.com/) — Leia a documentação


<hr>
<div align="center">
<h3>⭐ Dê uma estrela no GitHub!</h3>

<p>Isso ajuda o projeto a alcançar as equipes que precisam dele.</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>Feito com ❤️ pela <a href="https://www.pipeshub.com/">equipe do PipesHub</a> e colaboradores ao redor do mundo.</sub></p>

</div>
