<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](../vi/README.md) · **Italiano**

</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 piattaforma di IA per il lavoro, open source</h3>

<p>
  <a href="https://www.pipeshub.com/">Sito web</a> ·
  <a href="https://docs.pipeshub.com/">Documentazione</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 — Spiegabile ed Estensibile</h2>

<strong>[PipesHub](https://www.pipeshub.com/)</strong> è un livello di esecuzione nativo per l'IA, open source e auto-ospitabile, che collega la conoscenza aziendale, offre una ricerca spiegabile con citazioni e automatizza i flussi di lavoro nei tuoi sistemi.


## Funzionalità

- 📝 **Risposte spiegabili:** PipesHub fornisce risposte fondate con citazioni precise per blocchi ai documenti originali.
- 🔒 **Ricerca consapevole dei permessi:** Applica controlli di accesso a livello di fonte, così gli utenti vedono solo ciò a cui sono autorizzati.
- 🕸️ **Recupero tramite grafo della conoscenza:** Recupero basato su grafi che cattura le relazioni tra i dati aziendali.
- 🔌 **Connettori aziendali:** Oltre 30 connettori con indicizzazione in tempo reale e pianificata, pronti all'uso.
- 🔍 **Ricerca unificata, ricerca approfondita e agenti:** Ricerca, domande e risposte, ricerca approfondita, ricerca sul web e agenti IA su un unico livello di contesto.
- 📊 **Artefatti ed esecuzione di codice:** Genera report, grafici e dashboard in una sandbox di esecuzione sicura.
- 🎙️ **Supporto multimodale:** Comprensione di immagini, diagrammi e file scansionati, oltre all'interazione vocale.
- 🤖 **Agenti e azioni no-code:** Crea agenti in modo visivo ed esegui azioni sugli strumenti aziendali.
- 🧠 **Porta il tuo modello, completamente auto-ospitabile:** Qualsiasi provider di LLM, distribuito nella tua VPC — i dati non lasciano mai la tua infrastruttura.
- 🛠️ **Pensato per gli sviluppatori ed estensibile:** API, SDK, strumenti MCP, connettori personalizzati e servizi scalabili in modo indipendente.

## PipesHub in azione

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

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

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

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

## Connettori

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

## Formati di file supportati

| Formato | Dettagli |
|--------|---------|
| PDF | Inclusi i PDF scansionati |
| Docx / Doc | Microsoft Word |
| XLSX / XLS | Microsoft Excel |
| PPTX / PPT | Microsoft PowerPoint |
| CSV | Valori separati da virgola |
| Markdown | File .md |
| HTML | Pagine web |
| Text | File di testo semplice |
| Google Docs, Sheets, Slides | Formati di Google Workspace |
| Immagini | PNG, JPG, ecc. |
| Audio | File audio |
| Video | File video |

## Stack tecnologico

### Frontend

| Tecnologia | Descrizione |
|-----------|-------------|
| Next.js | UI con App Router (React renderizzato lato client) |
| TypeScript | Superset di JavaScript fortemente tipizzato |
| Radix UI Themes | Primitive di componenti accessibili e stile |
| Zod | Validazione e parsing degli schemi |
| React Hook Form | Gestione flessibile dello stato dei form |

### Backend

| Tecnologia | Descrizione |
|-----------|-------------|
| FastAPI | Framework web Python ad alte prestazioni |
| LangChain | Framework per pipeline di LLM |
| LangGraph | Grafo di stati per i flussi di lavoro di LLM |
| Qdrant | Motore di ricerca per similarità vettoriale |
| Neo4j / ArangoDB | Database a grafo |
| Kafka / Redis Streams | Piattaforma distribuita di streaming di eventi |
| Redis | Caching |
| Redis / etcd3 | Archivio di configurazione chiave-valore distribuito |
| Celery | Sistema distribuito di code di attività |
| Docling | Toolkit per l'analisi e l'estrazione di documenti |
| PyMuPDF | Libreria per l'elaborazione di PDF |
| pandas | Analisi e manipolazione dei dati |

## 🚀 Guida al deployment

PipesHub (la piattaforma di IA per il lavoro) può essere eseguito localmente o distribuito sul cloud usando Docker Compose.
**Nota**: Se distribuisci PipesHub su un server cloud, assicurati di usare un endpoint HTTPS. PipesHub applica controlli di sicurezza più rigorosi e i browser bloccheranno alcune richieste quando l'applicazione è servita via HTTP.
Puoi usare un reverse proxy come Cloudflare, Nginx o Traefik per terminare SSL/TLS e fornire un certificato HTTPS valido.
Se vedi una schermata bianca dopo aver distribuito PipesHub accedendovi via HTTP, questa è probabilmente la causa. Il frontend rifiuterà di caricarsi a causa dei controlli di sicurezza più rigorosi.

---

### 📦 Deployment in produzione

```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 di deployment per sviluppatori

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

Il `Dockerfile` principale recupera layer precompilati da `pipeshubai/pipeshub-ai-base:python-deps` e `pipeshubai/pipeshub-ai-base:runtime` (consulta [`Dockerfile.base`](../../../Dockerfile.base) nella radice del repository per i comandi di build/push). Per usare invece tag locali, imposta `PYTHON_DEPS_IMAGE` e `RUNTIME_BASE_IMAGE` nell'ambiente o negli argomenti di build di compose.

## Server MCP

Usa PipesHub con qualsiasi client compatibile con MCP per portare il contesto della tua azienda nei flussi di lavoro di IA. Consulta il README per la configurazione e l'uso.

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

## SDK

PipesHub fornisce SDK per sviluppatori in Python, TypeScript e Go per aiutarti a integrare rapidamente. Consulta il README del rispettivo repository SDK per i dettagli di configurazione e utilizzo.

| Nome | Descrizione | Link |
|------|-------------|------|
| **Python SDK** | SDK Python per PipesHub | [pipeshub-ai/pipeshub-sdk-python](https://github.com/pipeshub-ai/pipeshub-sdk-python) |
| **TypeScript SDK** | SDK TypeScript per PipesHub | [pipeshub-ai/pipeshub-sdk-typescript](https://github.com/pipeshub-ai/pipeshub-sdk-typescript) |
| **Go SDK** | SDK Go per PipesHub | [pipeshub-ai/pipeshub-sdk-go](https://github.com/pipeshub-ai/pipeshub-sdk-go) |

> Ti serve un SDK in un altro linguaggio? Scrivici a developer@pipeshub.com

## Roadmap

<p>Sviluppiamo in modo aperto. Ecco cosa è stato fatto e cosa arriverà:</p>

<ul>
<li>✅ 🤖 <strong>Agenti IA per il lavoro</strong>: costruttore di agenti no-code di prima classe</li>
<li>✅ 🔗 Supporto a <strong>MCP (Model Context Protocol)</strong>, sia server che client</li>
<li>✅ 🧰 <strong>SDK per sviluppatori</strong></li>
<li>✅ 🔍 <strong>Ricerca di codice</strong> su GitHub, GitLab e Bitbucket</li>
<li>⬜ 👤 <strong>Ricerca personalizzata</strong> in base a team, ruolo e cronologia</li>
<li>✅ ☸️ Deployment <strong>Kubernetes in produzione</strong> con impostazioni di alta disponibilità predefinite</li>
<li>⬜ 📈 <strong>Rilevanza potenziata da PageRank</strong> sull'intero grafo della conoscenza</li>
</ul>
<p>👉 <strong><a href="https://plum-myrtle-9f7.notion.site/Pipeshub-s-Product-Roadmap-33841c164f54803a9989fd0fdbfdb1ee">Consulta la roadmap completa del prodotto su Notion</a></strong></p>

<hr>

## 👥 Contribuire

Vuoi unirti alla nostra comunità di sviluppatori? Consulta la nostra [Guida ai contributi](CONTRIBUTING.md) per maggiori dettagli su come configurare l'ambiente di sviluppo, i nostri standard di codice e il flusso di lavoro dei contributi.
<h3>Dove andare per cosa</h3>

<table>

<tr><td>Fare una domanda o ricevere aiuto</td><td><a href="https://discord.com/invite/K5RskzJBm2">Discord</a></td></tr>
<tr><td>Segnalare un bug o richiedere una funzionalità</td><td><a href="https://github.com/pipeshub-ai/pipeshub-ai/issues">GitHub Issues</a></td></tr>
<tr><td>Segnalare un problema di sicurezza</td><td><a href="SECURITY.md">Segnala un problema di sicurezza</a></td></tr>
<tr><td>Leggere la documentazione</td><td><a href="https://docs.pipeshub.com/">Documentazione Pipeshub</a></td></tr>
</tbody>
</table>

## Domande frequenti

### Che cos'è PipesHub?

PipesHub è un livello di esecuzione nativo per l'IA, open source e auto-ospitabile, che collega la conoscenza aziendale, offre una ricerca spiegabile con citazioni e automatizza i flussi di lavoro nei tuoi sistemi. Fornisce un livello di contesto unificato per ricerca, domande e risposte, ricerca approfondita, ricerca sul web e agenti IA.

### In cosa si differenzia PipesHub dagli altri strumenti di IA per il lavoro?

PipesHub è completamente open source (Apache 2.0) e auto-ospitabile — i tuoi dati non lasciano mai la tua infrastruttura. Offre una ricerca consapevole dei permessi che applica controlli di accesso a livello di fonte e fornisce risposte spiegabili con citazioni precise per blocchi ai documenti originali.

### Quali connettori supporta PipesHub?

PipesHub dispone di oltre 30 connettori aziendali con indicizzazione in tempo reale e pianificata. Supporta formati di file come PDF, Docx, XLSX, PPTX, CSV, Markdown, HTML, Google Docs/Sheets/Slides, immagini, audio e video.

### Come si distribuisce 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 per i deployment sul cloud. L'HTTP può causare blocchi di sicurezza nel frontend.

### Quali provider di LLM supporta PipesHub?

PipesHub adotta il principio "Porta il tuo modello" — puoi usare qualsiasi provider di LLM. Distribuisci nella tua VPC con i modelli che preferisci. Lo stack tecnologico include LangChain e LangGraph per le pipeline e i flussi di lavoro di LLM.

### Che cos'è la funzionalità di recupero tramite grafo della conoscenza?

PipesHub usa un recupero basato su grafi che cattura le relazioni tra i dati aziendali. Utilizza Neo4j o ArangoDB come database a grafo, combinati con Qdrant per la ricerca per similarità vettoriale.

### PipesHub ha un server MCP?

Sì. PipesHub fornisce un server MCP per l'integrazione con qualsiasi client compatibile con MCP. Repository: [pipeshub-ai/mcp-server](https://github.com/pipeshub-ai/mcp-server/).

### Quali SDK sono disponibili?

PipesHub fornisce SDK per:
- **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 creare agenti IA senza programmare?

Sì. PipesHub ha un costruttore di agenti no-code. Puoi creare agenti in modo visivo ed eseguire azioni sugli strumenti aziendali senza scrivere codice.

### Che cos'è il supporto multimodale?

PipesHub supporta la comprensione di immagini, diagrammi e file scansionati, oltre all'interazione vocale. Usa Docling e PyMuPDF per l'analisi dei documenti e Azure Document Intelligence o un LLM multimodale (VLM) per l'OCR dei PDF scansionati.

### Come risolvo i problemi di deployment?

1. Assicurati che HTTPS sia configurato per i deployment sul cloud
2. Controlla i log di Docker compose: `docker compose logs`
3. Verifica le variabili d'ambiente in env.template
4. Consulta [docs.pipeshub.com](https://docs.pipeshub.com/) per guide dettagliate

### Dove posso ottenere aiuto?

- [Discord](https://discord.com/invite/K5RskzJBm2) — Fai domande e ottieni aiuto
- [GitHub Issues](https://github.com/pipeshub-ai/pipeshub-ai/issues) — Segnala bug o richiedi funzionalità
- [Documentazione PipesHub](https://docs.pipeshub.com/) — Leggi la documentazione


<hr>
<div align="center">
<h3>⭐ Mettici una stella su GitHub!</h3>

<p>Aiuta il progetto a raggiungere i team che ne hanno bisogno.</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>Creato con ❤️ dal <a href="https://www.pipeshub.com/">team di PipesHub</a> e dai contributori di tutto il mondo.</sub></p>

</div>
