Windows に Docling をインストール——PATH で悩まない手順

PowerShell でインストール#

py -3.12 -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install -U pip
pip install docling
docling --version

有効化で “running scripts is disabled on this system”（このシステムではスクリプトの実行が無効）と出たら、自分のユーザーにローカルで作成したスクリプトを一度だけ許可して、もう一度有効化します：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

cmd.exe では .venv\Scripts\activate.bat を使います。

NVIDIA GPU#

nvidia-smi                                   # "CUDA Version" を確認
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu132   # torch 2.15.0、ドライバーの CUDA ≥ 13.2。古いドライバーは cu130 か cu126（torch 2.14.1）
pip install docling
python -c "import torch; print(torch.cuda.is_available())"

PyPI にある PyTorch の Windows 版は NVIDIA のパッケージに依存しないため、そのまま pip install docling すると CPU 専用の PyTorch になります。先に CUDA のインデックスから入れることで GPU が使えるようになります。cu132 と cu134 に torch 2.15.0 の Windows x86_64 ビルドがあることを確認しました。cu130 と cu126 は 2.14.1 まで。

「docling は認識されません」#

コマンドは .venv\Scripts にあります。仮想環境を有効にするか、モジュールを直接呼び出します。こちらは常に動きます：

python -m docling.cli.main convert report.pdf --to md

OCR・Office・音声のツール#

Hugging Face のキャッシュ警告#

開発者モードが無効な Windows では、huggingface_hub がキャッシュでシンボリックリンクを使えないと警告することがあります。ダウンロードは問題なく動き、代わりにファイルがコピーされるためディスクを多く使います。開発者モードを有効にするか、HF_HOME 環境変数でキャッシュを容量の大きいドライブに移してください。

WSL と Docker#

Linux のツールが好みなら、WSL 2 の中でも同じ手順で Docling をインストールできます（Linux ガイド参照）。公式の docling-serve イメージは Docker Desktop で動きます。

よくある質問

出典

• Windows 版 Python（python.org）
• Microsoft：about_Execution_Policies
• PyTorch：ローカルでの開始（CUDA 版）