基本インストール
Capybara の PyPI パッケージ名は capybara-docsaid です。Python 3.10+ が必要です。
PyPI からインストール(core)
pip install capybara-docsaid
python -c "import capybara; print(capybara.__version__)"
optional 機能(extras)
推論 backend と一部機能は extras として分離されています。必要に応じて追加インストールしてください:
# ONNXRuntime(CPU)
pip install "capybara-docsaid[onnxruntime]"
# ONNXRuntime(GPU)
pip install "capybara-docsaid[onnxruntime-gpu]"
# OpenVINO
pip install "capybara-docsaid[openvino]"
# TorchScript
pip install "capybara-docsaid[torchscript]"
# 可視化描画(matplotlib/pillow)
pip install "capybara-docsaid[visualization]"
# IPCam demo(flask)
pip install "capybara-docsaid[ipcam]"
# システム情報(psutil)
pip install "capybara-docsaid[system]"
# 全部
pip install "capybara-docsaid[all]"
システム依存パッケージ(機能に応じて)
一部機能は OS 依存の codec / 変換ツールに依存します:
- JPEG の高速 I/O(
PyTurboJPEG):TurboJPEG library - HEIC/HEIF(
pillow-heif):libheif - PDF → 画像(
pdf2image):Poppler(pdftoppm/pdftocairo) - 動画抽出:
ffmpeg(OpenCV の動画読み取りが安定しやすい)
Ubuntu
sudo apt install ffmpeg libturbojpeg libheif-dev poppler-utils
macOS
brew install ffmpeg jpeg-turbo libheif poppler
Git からインストール
pip install git+https://github.com/DocsaidLab/Capybara.git
ローカル開発の場合:
pip install -e .
Windows
Windows での動作は十分にテストしていません。WSL2 または Docker を推奨します: 進階インストール。
GPU 注意事項(ONNXRuntime CUDA)
onnxruntime-gpu を使用する場合、ORT のバージョンに対応する CUDA/cuDNN をインストールしてください: