Communitygithub.com

sid732/LocalContextRouter

Enrutador previo que decide localmente si cada página de un documento debe enviarse a un modelo multimodal como texto, OCR en el dispositivo o imagen. Reduce el costo de tokens de visión. macOS.

¿Qué es LocalContextRouter?

Local Context Router es una habilidad para agentes de IA que actúa como un enrutador previo antes de procesar documentos PDF, escaneos o capturas de pantalla con un modelo multimodal. En lugar de que el modelo lea el texto completo y renderice cada página como imagen (pagando por ambos), esta herramienta analiza cada página localmente y clasifica su contenido en tres categorías: texto puro (se usa el texto extraído), páginas solo imagen con OCR en el dispositivo (se usa el texto OCR), y páginas visuales como tablas, gráficos o diagramas (se adjunta la imagen). Está diseñada para macOS y se instala mediante pip. Al ejecutar `localctx` con un documento, produce un archivo JSON con instrucciones claras sobre qué parte del contenido usar y cuántos tokens se ahorraron, todo sin enviar datos fuera del equipo. Es útil para desarrolladores y agentes que trabajan con modelos multimodales y buscan optimizar costos de tokens de visión sin comprometer la precisión en páginas complejas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add sid732/LocalContextRouter

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Local Context Router

Un modelo multimodal lee un PDF extrayendo su texto y renderizando cada página como imagen, pagando por ambos. En una página que es mayormente texto, la imagen es un gasto innecesario. Ejecute este enrutador previo primero y envíe al modelo solo lo que cada página necesita.

Cuándo usarlo

Antes de leer, resumir o extraer información de un PDF, escaneo o captura de pantalla que el usuario haya compartido.

Requisitos

El paquete localcontextrouter debe estar instalado (pip install localcontextrouter, macOS). Proporciona el comando localctx que se usa a continuación.

Ejecución

Enrute el documento y lea el JSON, renderizando las páginas visuales en una carpeta:

localctx <ruta-al-documento> --json --vision-dir ./lcr-pages

Si el comando localctx no está disponible, ejecute el script incluido con un Python que tenga instalado localcontextrouter (el script importa el mismo paquete):

python scripts/preflight.py <ruta-al-documento> --json --vision-dir ./lcr-pages

Usar el resultado

El JSON contiene tokens_saved y un arreglo pages. Cada página tiene source, text, text_tokens, image_tokens e image:

  • source: "text": use text directamente; no adjunte la imagen.
  • source: "ocr": la página era solo imagen y ha sido OCR en el dispositivo; use text.
  • source: "vision": la página es una tabla, gráfico o diagrama; adjunte la imagen en image para que el modelo pueda leerla. El text es solo un respaldo aproximado.

Ensamble las páginas de texto y OCR en orden de lectura, adjunte imágenes solo para las páginas de visión, y mencione tokens_saved si al usuario le importa el costo.

Notas

Todo se ejecuta localmente y sin conexión; el documento no sale del equipo.

Skills relacionados