Communitygithub.com

LocalContextRouter

Pré-roteador local que decide se cada página de um documento deve ser enviada para um modelo multimodal como texto, OCR no dispositivo ou imagem. Reduz custos com tokens de visão. macOS.

O que é LocalContextRouter?

O LocalContextRouter é um pré-processador inteligente que analisa documentos PDF, scans ou capturas de tela antes de enviá-los a um modelo multimodal como Claude, GPT-4V ou Gemini. Sua função principal é classificar cada página do documento em uma de três categorias: texto simples, OCR (reconhecimento óptico de caracteres) ou imagem complexa (tabelas, gráficos, diagramas). Essa pré-análise reduz drasticamente o consumo de tokens de visão, que são mais caros que tokens de texto, pois evita converter páginas predominantemente textuais em imagens. A ferramenta é exclusiva para macOS e requer a instalação do pacote `localcontextrouter` via pip. Ela gera um arquivo JSON com instruções claras sobre como o modelo deve processar cada página, incluindo o texto extraído, a rota sugerida e a quantidade de tokens economizada. Todo o processamento é feito localmente e offline, garantindo que o documento jamais saia da máquina do usuário, o que é essencial para dados sensíveis ou confidenciais. Com essa abordagem, desenvolvedores podem otimizar o custo de uso de APIs de modelos multimodais sem perder a capacidade de processar documentos complexos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add sid732/LocalContextRouter

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Local Context Router

Um modelo multimodal lê um PDF extraindo seu texto e renderizando cada página como uma imagem, e depois pagando por ambos. Em uma página que é principalmente texto, a imagem é um gasto desperdiçado. Execute este pré-roteador primeiro e envie ao modelo apenas o que cada página precisa.

Quando usar

Antes de ler, resumir ou extrair informações de um PDF, scan ou captura de tela que o usuário compartilhou.

Requisitos

O pacote localcontextrouter deve estar instalado (pip install localcontextrouter, masculino). Ele fornece o comando localctx usado abaixo.

Executar

Roteie o documento e leia o JSON, renderizando as páginas visuais em uma pasta:

localctx <caminho-para-documento> --json --vision-dir ./lcr-pages

Se o comando localctx não estiver disponível, execute o script incluído com um Python que tenha localcontextrouter instalado (o script importa o mesmo pacote):

python scripts/preflight.py <caminho-para-documento> --json --vision-dir ./lcr-pages

Usar o resultado

O JSON contém tokens_saved e um array pages. Cada página carrega source, text, text_tokens, image_tokens e image:

  • source: "text": use text diretamente; não anexe a imagem.
  • source: "ocr": a página era apenas imagem e foi submetida a OCR no dispositivo; use text.
  • source: "vision": a página é uma tabela, gráfico ou diagrama; anexe a imagem em image para que o modelo possa lê-la. O text é apenas um fallback grosseiro.

Monte as páginas de texto e OCR na ordem de leitura, anexe imagens apenas para as páginas de visão, e mencione tokens_saved se o usuário se importar com custos.

Notas

Tudo é executado localmente e offline; o documento não sai da máquina.

Habilidades Relacionadas