<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** · [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>La plataforma de IA para el trabajo, de código abierto</h3>

<p>
  <a href="https://www.pipeshub.com/">Sitio web</a> ·
  <a href="https://docs.pipeshub.com/">Documentación</a> ·
  <a href="https://discord.com/invite/K5RskzJBm2">Discord</a> ·
  <a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Hoja de ruta</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: explicable y extensible</h2>

<strong>[PipesHub](https://www.pipeshub.com/)</strong> es una capa de ejecución nativa de IA, de código abierto y autoalojable, que conecta el conocimiento empresarial, ofrece búsqueda explicable con citas y automatiza flujos de trabajo en todos tus sistemas.


## Funcionalidades

- 📝 **Respuestas explicables:** PipesHub ofrece respuestas fundamentadas con citas precisas de bloques a los documentos originales.
- 🔒 **Búsqueda con reconocimiento de permisos:** Aplica controles de acceso a nivel de fuente para que los usuarios solo vean aquello a lo que están autorizados.
- 🕸️ **Recuperación con grafo de conocimiento:** Recuperación basada en grafos que captura las relaciones entre los datos empresariales.
- 🔌 **Conectores empresariales:** Más de 30 conectores con indexación en tiempo real y programada, listos para usar.
- 🔍 **Búsqueda unificada, investigación profunda y agentes:** Búsqueda, preguntas y respuestas, investigación profunda, búsqueda web y agentes de IA sobre una única capa de contexto.
- 📊 **Artefactos y ejecución de código:** Genera informes, gráficos y paneles en un entorno de ejecución aislado y seguro.
- 🎙️ **Soporte multimodal:** Comprensión de imágenes, diagramas y archivos escaneados, además de interacción por voz.
- 🤖 **Agentes y acciones sin código:** Crea agentes de forma visual y ejecuta acciones en las herramientas empresariales.
- 🧠 **Usa tu propio modelo, totalmente autoalojable:** Cualquier proveedor de LLM, desplegado en tu VPC: los datos nunca salen de tu infraestructura.
- 🛠️ **Pensado para desarrolladores y extensible:** API, SDK, herramientas MCP, conectores personalizados y servicios escalables de forma independiente.

## PipesHub en acción

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

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

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

### Búsqueda de conocimiento
<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 archivo compatibles

| Formato | Detalles |
|--------|---------|
| PDF | Incluidos los PDF escaneados |
| Docx / Doc | Microsoft Word |
| XLSX / XLS | Microsoft Excel |
| PPTX / PPT | Microsoft PowerPoint |
| CSV | Valores separados por comas |
| Markdown | Archivos .md |
| HTML | Páginas web |
| Text | Archivos de texto plano |
| Google Docs, Sheets, Slides | Formatos de Google Workspace |
| Imágenes | PNG, JPG, etc. |
| Audio | Archivos de audio |
| Vídeo | Archivos de vídeo |

## Stack tecnológico

### Frontend

| Tecnología | Descripción |
|-----------|-------------|
| Next.js | UI con App Router (React renderizado en el cliente) |
| TypeScript | Superconjunto de JavaScript con tipado fuerte |
| Radix UI Themes | Primitivos de componentes accesibles y estilos |
| Zod | Validación y análisis de esquemas |
| React Hook Form | Gestión flexible del estado de formularios |

### Backend

| Tecnología | Descripción |
|-----------|-------------|
| FastAPI | Framework web de Python de alto rendimiento |
| LangChain | Framework para pipelines de LLM |
| LangGraph | Grafo de estados para flujos de trabajo de LLM |
| Qdrant | Motor de búsqueda por similitud vectorial |
| Neo4j / ArangoDB | Base de datos de grafos |
| Kafka / Redis Streams | Plataforma de streaming de eventos distribuida |
| Redis | Almacenamiento en caché |
| Redis / etcd3 | Almacén de configuración clave-valor distribuido |
| Celery | Sistema de colas de tareas distribuidas |
| Docling | Kit de herramientas de análisis y extracción de documentos |
| PyMuPDF | Biblioteca de procesamiento de PDF |
| pandas | Análisis y manipulación de datos |

## 🚀 Guía de despliegue

PipesHub (la plataforma de IA para el trabajo) puede ejecutarse localmente o desplegarse en la nube mediante Docker Compose.
**Nota**: Si despliegas PipesHub en un servidor en la nube, asegúrate de usar un endpoint HTTPS. PipesHub aplica comprobaciones de seguridad más estrictas y los navegadores bloquearán ciertas solicitudes cuando la aplicación se sirve por HTTP.
Puedes usar un proxy inverso como Cloudflare, Nginx o Traefik para terminar el SSL/TLS y proporcionar un certificado HTTPS válido.
Si ves una pantalla en blanco tras desplegar PipesHub al acceder por HTTP, lo más probable es que esta sea la causa. El frontend se negará a cargar debido a las comprobaciones de seguridad más estrictas.

---

### 📦 Despliegue en producció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 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
```

### 📦 Compilación de despliegue para desarrolladores

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

El `Dockerfile` principal obtiene capas precompiladas desde `pipeshubai/pipeshub-ai-base:python-deps` y `pipeshubai/pipeshub-ai-base:runtime` (consulta [`Dockerfile.base`](../../../Dockerfile.base) en la raíz del repositorio para ver los comandos de compilación/publicación). Para usar etiquetas locales en su lugar, define `PYTHON_DEPS_IMAGE` y `RUNTIME_BASE_IMAGE` en el entorno o en los argumentos de compilación de compose.

## Servidor MCP

Usa PipesHub con cualquier cliente compatible con MCP para llevar el contexto de tu empresa a tus flujos de trabajo de IA. Consulta el README para la configuración y el uso.

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

## SDK

PipesHub ofrece SDK para desarrolladores en Python, TypeScript y Go para ayudarte a integrar rápidamente. Consulta el README del repositorio del SDK correspondiente para ver los detalles de configuración y uso.

| Nombre | Descripción | Enlace |
|------|-------------|------|
| **Python SDK** | SDK de Python para PipesHub | [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python) |
| **TypeScript SDK** | SDK de TypeScript para PipesHub | [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript) |
| **Go SDK** | SDK de Go para PipesHub | [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go) |

> ¿Necesitas un SDK en otro lenguaje? Escríbenos a developer@pipeshub.com

## Hoja de ruta

<p>Desarrollamos en abierto. Esto es lo que ya está hecho y lo que viene a continuación:</p>

<ul>
<li>✅ 🤖 <strong>Agentes de IA para el trabajo</strong>: constructor de agentes sin código de primer nivel</li>
<li>✅ 🔗 Soporte de <strong>MCP (Model Context Protocol)</strong>, tanto servidor como cliente</li>
<li>✅ 🧰 <strong>SDK para desarrolladores</strong></li>
<li>✅ 🔍 <strong>Búsqueda de código</strong> en GitHub, GitLab y Bitbucket</li>
<li>⬜ 👤 <strong>Búsqueda personalizada</strong> según el equipo, el rol y el historial</li>
<li>✅ ☸️ Despliegue en <strong>Kubernetes para producción</strong> con valores de alta disponibilidad por defecto</li>
<li>⬜ 📈 <strong>Relevancia mejorada con PageRank</strong> en todo el grafo de conocimiento</li>
</ul>
<p>👉 <strong><a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Consulta la hoja de ruta completa del producto en Notion</a></strong></p>

<hr>

## 👥 Contribuir

¿Quieres unirte a nuestra comunidad de desarrolladores? Consulta nuestra [Guía de contribución](CONTRIBUTING.md) para conocer más detalles sobre cómo configurar el entorno de desarrollo, nuestros estándares de código y el flujo de trabajo de contribución.
<h3>Dónde acudir para cada cosa</h3>

<table>

<tr><td>Hacer una pregunta u obtener ayuda</td><td><a href="https://discord.com/invite/K5RskzJBm2">Discord</a></td></tr>
<tr><td>Reportar un error o solicitar una función</td><td><a href="https://github.com/pipeshub-ai/pipeshub-ai/issues">GitHub Issues</a></td></tr>
<tr><td>Reportar un problema de seguridad</td><td><a href="SECURITY.md">Reportar problema de seguridad</a></td></tr>
<tr><td>Leer la documentación</td><td><a href="https://docs.pipeshub.com/">Documentación de Pipeshub</a></td></tr>
</tbody>
</table>

## Preguntas frecuentes

### ¿Qué es PipesHub?

PipesHub es una capa de ejecución nativa de IA, de código abierto y autoalojable, que conecta el conocimiento empresarial, ofrece búsqueda explicable con citas y automatiza flujos de trabajo en todos tus sistemas. Proporciona una capa de contexto unificada para búsqueda, preguntas y respuestas, investigación profunda, búsqueda web y agentes de IA.

### ¿En qué se diferencia PipesHub de otras herramientas de IA para el trabajo?

PipesHub es totalmente de código abierto (Apache 2.0) y autoalojable: tus datos nunca salen de tu infraestructura. Incorpora una búsqueda con reconocimiento de permisos que aplica controles de acceso a nivel de fuente, y ofrece respuestas explicables con citas precisas de bloques a los documentos originales.

### ¿Qué conectores admite PipesHub?

PipesHub cuenta con más de 30 conectores empresariales con indexación en tiempo real y programada. Admite formatos de archivo como PDF, Docx, XLSX, PPTX, CSV, Markdown, HTML, Google Docs/Sheets/Slides, imágenes, audio y vídeo.

### ¿Cómo despliego 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
```

Nota: Usa HTTPS para los despliegues en la nube. HTTP puede provocar bloqueos de seguridad en el frontend.

### ¿Qué proveedores de LLM admite PipesHub?

PipesHub funciona con el modelo "Usa tu propio modelo": puedes usar cualquier proveedor de LLM. Despliega en tu VPC con los modelos que prefieras. El stack tecnológico incluye LangChain y LangGraph para pipelines y flujos de trabajo de LLM.

### ¿Qué es la función de recuperación con grafo de conocimiento?

PipesHub usa una recuperación basada en grafos que captura las relaciones entre los datos empresariales. Utiliza Neo4j o ArangoDB como bases de datos de grafos, combinadas con Qdrant para la búsqueda por similitud vectorial.

### ¿Tiene PipesHub un servidor MCP?

Sí. PipesHub ofrece un servidor MCP para integrarse con cualquier cliente compatible con MCP. Repositorio: [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/).

### ¿Qué SDK están disponibles?

PipesHub ofrece SDK 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)

### ¿Puedo crear agentes de IA sin programar?

Sí. PipesHub tiene un constructor de agentes sin código. Puedes crear agentes de forma visual y ejecutar acciones en las herramientas empresariales sin escribir código.

### ¿Qué es el soporte multimodal?

PipesHub admite la comprensión de imágenes, diagramas y archivos escaneados, además de la interacción por voz. Utiliza Docling y PyMuPDF para el análisis de documentos, y Azure Document Intelligence o un LLM multimodal (VLM) para el OCR de PDF escaneados.

### ¿Cómo soluciono problemas de despliegue?

1. Asegúrate de que HTTPS está configurado para los despliegues en la nube
2. Revisa los registros de Docker compose: `docker compose logs`
3. Verifica las variables de entorno en env.template
4. Consulta [docs.pipeshub.com](https://docs.pipeshub.com/) para guías detalladas

### ¿Dónde puedo obtener ayuda?

- [Discord](https://discord.com/invite/K5RskzJBm2): haz preguntas y obtén ayuda
- [GitHub Issues](https://github.com/pipeshub-ai/pipeshub-ai/issues): reporta errores o solicita funciones
- [Documentación de PipesHub](https://docs.pipeshub.com/): lee la documentación


<hr>
<div align="center">
<h3>⭐ ¡Danos una estrella en GitHub!</h3>

<p>Ayuda a que el proyecto llegue a los equipos que lo necesitan.</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>Creado con ❤️ por el <a href="https://www.pipeshub.com/">equipo de PipesHub</a> y colaboradores de todo el mundo.</sub></p>

</div>
