Pular para o conteúdo principal
O ChatCLI lê PDFs em todos os providers. Anexe um e o modelo responde com base nele: no chat, /coder, one-shot (-p), na web UI, em editores ACP e nos canais do gateway (Telegram, WhatsApp, Slack, Discord, webhook).

​
Como anexar

Aponte o @file para um PDF. Ele é anexado como documento, nunca colado como bytes crus:
No /coder, o modelo pode abrir um PDF por conta própria com o @view, a mesma tool que usa para imagens:
O documento entra no turno seguinte, e o modelo o lê por inteiro (inclusive páginas escaneadas, nos modelos que leem PDF nativamente).

​
Como cada provider recebe

A decisão é feita por provider e por modelo, no envio da mensagem:
  • Nativa: o modelo recebe o próprio PDF: texto, tabelas, gráficos e páginas escaneadas.
  • Texto extraído: o ChatCLI extrai o texto localmente (Go puro, sem ferramenta externa), página a página com marcadores --- page N ---, para o modelo poder citar páginas.
Um PDF acima do limite nativo do provider vai como texto: 32 MB na Anthropic, 20 MB no Bedrock InvokeModel, 4,5 MB no Bedrock Converse (até 5 documentos), 50 MB nos demais, e no máximo 100 páginas no modo nativo.

​
PDFs escaneados em modelo só-texto

Um PDF escaneado não tem camada de texto, então não há o que extrair. Quando ele vai para um modelo sem entrada nativa de PDF, o ChatCLI pede antes a um modelo configurado que lê PDF para transcrevê-lo (o provider atual, depois qualquer outro configurado). Essa transcrição inclui figuras e diagramas, descritos brevemente. É ela que o modelo atual recebe:
Se nenhum modelo configurado conseguir lê-lo, você é avisado, e o modelo é instruído a não inventar o conteúdo.
CHATCLI_VISION_PROVIDER / CHATCLI_VISION_MODEL também escolhem o modelo dessa transcrição, quando esse modelo lê PDF.

​
Onde mais os PDFs são lidos

Um PDF que chega pela web UI ou por um cliente RPC também é salvo no diretório de estado privado do ChatCLI, e o caminho vai para o modelo, que pode relê-lo depois com @read.

​
Configuração

Um modelo também pode ser marcado no catálogo com a capability pdf (força nativo) ou no_pdf (força texto). Limites da extração: 50 MB por PDF anexado, até 500 páginas e 2 milhões de caracteres de texto, 60 segundos. PDFs protegidos por senha continuam sendo anexados para modelos nativos, que podem abri-los; a extração de texto não consegue lê-los.

Entrada de Imagem (Visão)

Anexe imagens: a mesma abordagem por provider.

Variáveis de ambiente

Todas as configurações em um só lugar.