Product2026-09-163 min de leitura

Por que não fizemos um aplicativo desktop

O PDF123 não vai lançar uma segunda interface de desktop. O uso offline e privado fica no Docker Compose com o pdfx, para o catálogo não divergir da API.

PDF123 · Updated 2026-09-18

Quando os arquivos não podem sair de uma rede privada, o pedido seguinte costuma ser um instalador para Windows ou macOS. Recusamos esse formato de propósito. Uma interface gráfica de desktop seria uma segunda base de código de interface. A divergência de recursos entre "o aplicativo" e /api/v1/ é quase inevitável depois que essas árvores se separam.

A restrição é o limite, não a aparência

"Os bytes ficam aqui" é atendido por um pdfx-server que você mesmo roda, e não por WinForms ou Electron especificamente. O Compose mais o pdfx (local ou --cloud contra a sua URL base) mantêm um único catálogo de operações por trás do navegador, do REST, do MCP e da CLI.

Como levantar essa pilha está documentado em Self-host: task docker:build / task docker:up para o Compose (API na :8080, portal na :3000), ou task pdfx:dev nativo ao lado do portal. Defina SECURITY_CUSTOMGLOBALAPIKEY quando quiser uma chave de acesso fixa. Este texto trata apenas de por que essa pilha não vira um produto de desktop.

O pdfx local, sem --cloud, roda o pdf-core na máquina que tem os arquivos. Isso já cobre tarefas em lote offline que nunca precisaram de interface gráfica. O modo nuvem serve para quando a mesma CLI deve atingir a sua URL base self-hosted ou hospedada com o mesmo contrato multipart do curl.

O que uma versão para desktop custaria

Os pacotes voltados ao consumidor otimizam edição em canvas, comparação visual e instaladores de loja. Sustentar essa superfície significa duplicar cada operação nova (opções de mesclagem, modos de OCR, padrões de sanitização) numa interface gráfica que não é o contrato OpenAPI já usado pelos agentes.

Plugins e canais de loja multiplicam o suporte sem melhorar MCP nem Idempotency-Key. Cada ciclo de revisão de loja e cada pedido de permissão do sistema consomem tempo que não chega ao /v1/openapi.json. No momento em que a árvore do desktop entrega uma opção de mesclagem que a API não tem (ou o contrário), automações e demonstrações passam a divergir em silêncio.

O OCR mostra por que a duplicação cobra caro. O caminho atual do servidor devolve Markdown (text/markdown) com os modos Auto e Force (ocrType=force-ocr para Force). Uma interface de desktop que ainda prometesse "PDF pesquisável com camada oculta" estaria mentindo sobre um fluxo diferente. Manter uma única definição de operação evita essa cisão.

Um catálogo, quatro clientes, nenhuma segunda interface

O produto já tem quatro formas de acesso às mesmas operações: o formulário do portal, o curl para /api/v1/…, o MCP em /mcp e o pdfx local ou em nuvem. Mesclar é o exemplo concreto: combinar PDFs na ordem de upload sem rasterizar páginas em imagens, quer você tenha clicado em Process, quer tenha enviado partes fileInput.

Uma edição desktop seria uma quinta forma de acesso, com um ciclo de lançamento separado. O modo de falha que nos preocupa não é "falta um ícone na bandeja do sistema". É "a página de demonstração continua funcionando enquanto o script que dependia da mesma operação regride em silêncio".

O que não estamos afirmando

Deixar o desktop de lado não inventa edição interativa no nível do Acrobat dentro do navegador. Ferramentas de formulário e tarefas HTTP continuam sendo o produto. Canvas de edição online, comparação visual e interfaces de assinatura para consumidor final ficam fora de escopo de propósito. Se você precisa de uma instalação privada, suba o Compose e aponte os clientes para a sua URL base. Se você precisa de um editor de pixels, use um pacote feito para isso; não espere um .exe do PDF123.

O PDF123 hospedado continua sendo o caminho anônimo rápido. O self-host é o mesmo kit de ferramentas atrás do seu firewall. Nenhum dos dois é uma terceira edição de desktop divergente. Para o contraste com conversores que só rodam no navegador, veja Por que hospedar você mesmo o kit de PDF. Para o que você ganha e o que precisa operar, veja O que o self-host realmente traz. Para ver como os quatro clientes que não são desktop se mantêm alinhados, veja A mesma operação em quatro clientes.

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool