Instalación

Instalar Docling en Windows

Windows 10 / 11 (64 bits) con Python 3.10+. La vía fiable más corta es Python 64 bits + entorno virtual + uv. Verifica cada comando contra la documentación oficial de instalación.

Step 1

Lista de requisitos

Buscas 3.10+ y 64. Si ves 32, desinstala ese Python e instala el build de 64 bits:

py --version; py -c "import struct; print(struct.calcsize('P')*8)"

Windows 10 u 11, 64 bits (el Python de 32 bits falla con los wheels torch).
Python 3.10, 3.11 o 3.12, 64 bits, desde python.org marcando «Add python.exe to PATH».
PowerShell (o Windows Terminal). Los comandos asumen PowerShell.
Unos 2–4 GB libres para descargas de modelos en la primera ejecución.

Step 2

Instala Python 64 bits correctamente

py --version

pip --version

Descarga el instalador Windows (64 bits) de Python 3.11 o 3.12.
En la primera pantalla marca «Add python.exe to PATH» y luego «Install Now».
Confirma en una ventana PowerShell nueva:

Si py no se encuentra, cierra y reabre el terminal (refresco del PATH) o reinstala con la opción PATH marcada. El shim de Python de Microsoft Store puede ocultar python: prefiere el lanzador py o el build de python.org.

Step 3

Entorno virtual en PowerShell

Si la política de ejecución bloquea la activación, ejecuta una vez Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser y vuelve a activar.

py -m venv .venv

.venv\Scripts\Activate.ps1

python -m pip install -U pip

Step 4

Instalación más rápida: uv (recomendado)

uv resuelve wheels precompiladas y evita la mayoría de fallos de compilador nativo en Windows. Con extras (ejemplo):

uv add docling

uv add "docling[rapidocr]"

O en un proyecto uv existente: uv venv --python 3.12, activa y luego uv pip install docling.

Step 5

Instalación estándar: pip

Si funciona, listo — salta a verificación. Si pip empieza a compilar paquetes y falla con error C++, no luches: cambia a uv o arregla la toolchain en la sección siguiente.

pip install docling

Step 6

Corrige «Microsoft Visual C++ 14.0 is required»

Por qué ocurre: algunas dependencias opcionales traen extensiones C++ nativas. Sin la toolchain MSVC, pip recurre a compilar desde fuente y falla. Solución A (fácil): usa uv para wheels en vez de compilador. Solución B: instala la toolchain:

winget install Microsoft.VisualStudio.2022.BuildTools

En el instalador selecciona la carga «Desarrollo para el escritorio con C++» (MSVC 14.0+).
Reinicia el terminal, reactiva el venv, borra el entorno a medio construir si hace falta y reintenta pip install docling.
El Docling base suele tener wheels — este error aparece sobre todo con extras como tesserocr o fasttext. Si solo un extra necesita compilar, considera rapidocr/easyocr.

Step 7

Extras OCR en Windows

Compara calidad e idiomas en la guía OCR. Para PDF escaneados fuerza OCR de página completa: docling convert scan.pdf --ocr-mode full_page.

Motor	Instalación en Windows	Notas
RapidOCR (el más fácil)	`pip install "docling[rapidocr]"`	Solo pip, sin binario del sistema. Buena opción por defecto en Windows.
EasyOCR	`pip install "docling[easyocr]"`	Solo pip, descarga mayor, buen multilingüe.
Tesseract	Binario UB Mannheim + PATH y `TESSDATA_PREFIX`, luego `pip install "docling[tesserocr]"`	Mejor control de precisión, pero requiere binario del sistema + datos.

Step 8

GPU / CUDA vía WSL2

El CUDA nativo en Windows depende de tu build PyTorch y drivers. La vía GPU fiable más simple es WSL2 con Ubuntu + drivers NVIDIA CUDA para WSL:

docling convert report.pdf --device cuda

Instala WSL2 + Ubuntu desde Microsoft Store y el driver NVIDIA de Windows con soporte WSL.
Dentro de WSL2 sigue la guía Linux (torch con CUDA) y selecciona el dispositivo explícitamente:

Verifica con python -c "import torch; print(torch.cuda.is_available())": debe imprimir True antes de que los flags GPU sirvan. Las instalaciones solo-CPU son totalmente válidas; la GPU solo añade velocidad.

Step 9

Verificación

Usa primero un PDF digital pequeño (sin OCR ni GPU). La primerísima ejecución descarga modelos: mantén la conexión. Luego prueba --to json y un motor OCR para confirmar cada capa.

docling --help

docling convert sample.pdf --to md

Step 10

Errores comunes en Windows

Instalación falla / C++ 14.0 requerido — ver falla la instalación y MSVC 14.0 requerido.
python abre Microsoft Store — usa el lanzador py o desactiva el alias de Store; prefiere el build de python.org.
Wheels torch 32 bits / «not a supported wheel» — tienes Python 32 bits; reinstala 64 bits.
Errores de permiso — nunca uses una shell admin como solución; un venv sin --user es la solución.
Primera conversión lenta — normal: se descargan modelos. Pre-descarga con docling-tools models download --all.

Step 11

FAQ de Windows

¿uv o pip en Windows?

Prefiere uv add docling. Resuelve wheels precompiladas y evita la toolchain MSVC que pip a veces exige para extras opcionales.

¿Necesito Visual Studio?

Solo si pip intenta compilar un extra nativo. El paquete base suele instalarse sin él. Ante el error C++ 14.0, instala Build Tools 2022 con carga C++ vía winget o cambia a uv.

¿Qué motor OCR es más fácil en Windows?

RapidOCR o EasyOCR: ambos solo con pip. Tesseract requiere el binario de sistema UB Mannheim más TESSDATA_PREFIX.

¿Puedo usar mi GPU NVIDIA en Windows?

Sí. El CUDA nativo funciona si tu build torch lo soporta; si no, WSL2 + Ubuntu con drivers CUDA es la vía más fiable, luego --device cuda.

¿PowerShell bloquea la activación del venv?

Ejecuta una vez Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser y luego .venv\Scripts\Activate.ps1 de nuevo.

Verificado con Docling v2.129.0 · Última comprobación 2026-09-22 · Fuente oficial