Repolode
icereed

icereed/paperless-gpt

Usa LLMs e OCR com visão para gerar títulos, tags, correspondentes e campos personalizados para documentos no paperless-ngx.

Estrelas
2,821
Forks
235
Issues abertas
190
Último commit
ontem

O que é?

paperless-gpt é um serviço complementar para o paperless-ngx, um sistema de gerenciamento de documentos auto-hospedado. Ele envia o conteúdo dos documentos a um LLM, como OpenAI, Mistral, Anthropic ou um modelo local do Ollama, e depois grava títulos, tags, correspondentes, datas dos documentos e campos personalizados sugeridos. Os usuários podem revisar as sugestões em uma interface web ou deixar que os documentos sejam processados automaticamente usando uma tag de acionamento.

O fluxo de OCR usa LLMs com capacidade de visão para extrair texto de digitalizações, e também pode usar Azure Document Intelligence, Google Document AI ou um servidor Docling auto-hospedado. Os prompts podem ser editados pela interface web, e os fluxos de trabalho permitem que cada tipo de documento use sua própria tag de acionamento e seus próprios prompts. O projeto também vincula, por meio dos campos Document Link do paperless-ngx, documentos que citam a mesma fatura, contrato ou número de processo.

O serviço é implantado com Docker, geralmente junto com o paperless-ngx no mesmo arquivo Compose. Ele não tem autenticação integrada, então o README recomenda colocá-lo atrás de um proxy reverso ou de uma VPN.

Recursos principais

  • 01Gera títulos, tags, correspondentes e datas de criação a partir do conteúdo dos documentos usando LLMs.
  • 02Extrai texto de digitalizações com LLMs com visão, Azure Document Intelligence, Google Document AI ou Docling.
  • 03É compatível com OpenAI, Mistral, Anthropic e modelos locais do Ollama.
  • 04Preenche campos personalizados nos modos de anexação, atualização ou substituição.
  • 05Permite editar prompts e definir fluxos de trabalho por tipo de documento na interface web.

Casos de uso

  • Organizar um grande acervo de documentos digitalizados no paperless-ngx sem precisar adicionar tags manualmente.
  • Digitalizar documentos com baixa qualidade, nos quais o OCR tradicional apresenta resultados insatisfatórios.
  • Vincular faturas, lembretes e contratos que fazem referência ao mesmo número de documento.
  • Executar o processamento de documentos com um modelo totalmente local do Ollama para manter os dados no próprio hardware.

Início rápido

  1. 1

    Instale o Docker

  2. 2

    Prepare uma instância do paperless-ngx em execução e um provedor de LLM (uma chave de API da OpenAI ou um servidor Ollama)

  3. 3

    Crie um docker-compose.yml junto ao paperless-ngx, com base no exemplo do README

  4. 4

    Inicie os serviços com o Docker Compose

Antes de usar

  • O paperless-gpt não tem autenticação integrada, portanto deve ser colocado atrás de um proxy reverso ou em uma rede restrita.
  • Ele precisa de um provedor de LLM, como uma chave de API da OpenAI ou um servidor Ollama em execução.

Em coleções

Tópicos

Perguntas frequentes

O que é paperless-gpt?
Usa LLMs e OCR com visão para gerar títulos, tags, correspondentes e campos personalizados para documentos no paperless-ngx. paperless-gpt é um serviço complementar para o paperless-ngx, um sistema de gerenciamento de documentos auto-hospedado. Ele envia o conteúdo dos documentos a um LLM, como OpenAI, Mistral, Anthropic ou um modelo local do Ollama, e depois grava títulos, tags, correspondentes, datas dos documentos e campos personalizados sugeridos. Os usuários podem revisar as sugestões em uma interface web ou deixar que os documentos sejam processados automaticamente usando uma tag de acionamento.
paperless-gpt é gratuito? Qual é a licença?
paperless-gpt é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
paperless-gpt ainda é mantido?
Manutenção ativa. O último commit de paperless-gpt foi em 6 de nov. de 2026.
Para que posso usar paperless-gpt?
Organizar um grande acervo de documentos digitalizados no paperless-ngx sem precisar adicionar tags manualmente. Digitalizar documentos com baixa qualidade, nos quais o OCR tradicional apresenta resultados insatisfatórios. Vincular faturas, lembretes e contratos que fazem referência ao mesmo número de documento. Executar o processamento de documentos com um modelo totalmente local do Ollama para manter os dados no próprio hardware.
Como instalar paperless-gpt?
Instale o Docker Prepare uma instância do paperless-ngx em execução e um provedor de LLM (uma chave de API da OpenAI ou um servidor Ollama) Crie um docker-compose.yml junto ao paperless-ngx, com base no exemplo do README Inicie os serviços com o Docker Compose
Onde consigo paperless-gpt?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/icereed/paperless-gpt

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados