Repolode
icereed

icereed/paperless-gpt

Usa LLM y OCR con visión para generar títulos, etiquetas, contactos y campos personalizados para documentos en paperless-ngx.

Estrellas
2,815
Forks
235
Issues abiertos
190
Último commit
hace 3 días

¿Qué es?

paperless-gpt es un servicio complementario para paperless-ngx, el sistema de gestión documental autoalojado. Envía el contenido de los documentos a un LLM, como OpenAI, Mistral, Anthropic o un modelo local de Ollama, y luego guarda los títulos, etiquetas, contactos, fechas de los documentos y campos personalizados sugeridos. Los usuarios pueden revisar las sugerencias en una interfaz web o dejar que los documentos se procesen automáticamente mediante una etiqueta de activación.

Su flujo de OCR usa LLM con capacidad de visión para extraer texto de documentos escaneados, y también puede usar Azure Document Intelligence, Google Document AI o un servidor Docling autoalojado. Las instrucciones se pueden editar desde la interfaz web, y los flujos de trabajo permiten que cada tipo de documento use su propia etiqueta de activación e instrucciones. El proyecto también vincula, mediante los campos Document Link de paperless-ngx, documentos que hacen referencia al mismo número de factura, contrato o expediente.

El servicio se despliega con Docker, normalmente junto con paperless-ngx en el mismo archivo Compose. No incluye autenticación, por lo que el README recomienda ubicarlo detrás de un proxy inverso o una VPN.

Funciones clave

  • 01Genera títulos, etiquetas, contactos y fechas de creación a partir del contenido de los documentos mediante LLM.
  • 02Extrae texto de documentos escaneados con LLM con capacidad de visión, Azure Document Intelligence, Google Document AI o Docling.
  • 03Es compatible con OpenAI, Mistral, Anthropic y modelos locales de Ollama.
  • 04Completa campos personalizados en los modos de anexar, actualizar o reemplazar.
  • 05Permite editar instrucciones y definir flujos de trabajo por tipo de documento en la interfaz web.

Casos de uso

  • Organizar una gran cantidad de documentos escaneados pendientes en paperless-ngx sin etiquetarlos manualmente.
  • Digitalizar documentos escaneados de mala calidad en los que el OCR tradicional ofrece resultados deficientes.
  • Vincular facturas, recordatorios y contratos que hagan referencia al mismo número de documento.
  • Procesar documentos con un modelo local de Ollama para mantener los datos en el propio hardware.

Inicio rápido

  1. 1

    Instala Docker

  2. 2

    Prepara una instancia de paperless-ngx en ejecución y un proveedor de LLM (una clave de API de OpenAI o un servidor de Ollama)

  3. 3

    Crea un docker-compose.yml junto a paperless-ngx, basándote en el ejemplo del README

  4. 4

    Inicia los servicios con Docker Compose

Antes de usarlo

  • paperless-gpt no incluye autenticación, por lo que debe ubicarse detrás de un proxy inverso o en una red restringida.
  • Necesita un proveedor de LLM, como una clave de API de OpenAI o un servidor de Ollama en ejecución.

En colecciones

Temas

Preguntas frecuentes

¿Qué es paperless-gpt?
Usa LLM y OCR con visión para generar títulos, etiquetas, contactos y campos personalizados para documentos en paperless-ngx. paperless-gpt es un servicio complementario para paperless-ngx, el sistema de gestión documental autoalojado. Envía el contenido de los documentos a un LLM, como OpenAI, Mistral, Anthropic o un modelo local de Ollama, y luego guarda los títulos, etiquetas, contactos, fechas de los documentos y campos personalizados sugeridos. Los usuarios pueden revisar las sugerencias en una interfaz web o dejar que los documentos se procesen automáticamente mediante una etiqueta de activación.
¿paperless-gpt es gratuito? ¿Qué licencia tiene?
paperless-gpt es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿paperless-gpt sigue mantenido?
Mantenimiento activo. El último commit de paperless-gpt fue el 3 nov 2026.
¿Para qué puedo usar paperless-gpt?
Organizar una gran cantidad de documentos escaneados pendientes en paperless-ngx sin etiquetarlos manualmente. Digitalizar documentos escaneados de mala calidad en los que el OCR tradicional ofrece resultados deficientes. Vincular facturas, recordatorios y contratos que hagan referencia al mismo número de documento. Procesar documentos con un modelo local de Ollama para mantener los datos en el propio hardware.
¿Cómo se instala paperless-gpt?
Instala Docker Prepara una instancia de paperless-ngx en ejecución y un proveedor de LLM (una clave de API de OpenAI o un servidor de Ollama) Crea un docker-compose.yml junto a paperless-ngx, basándote en el ejemplo del README Inicia los servicios con Docker Compose
¿Dónde consigo paperless-gpt?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/icereed/paperless-gpt

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados