DocuBrowse をインストール

Linux(RPM、DEB、tarball)、Windows(zip)、macOS(dmg)向けのパッケージ。GitHub Releases ページからダウンロードしてください。完全なステップごとの手引きは INSTALL.md を参照。

システム要件

	最小	推奨
RAM	8 GB	12 GB
CPU	x86_64 または ARM64	x86_64 または ARM64
GPU	なし(要約が遅くなります)	4 GB 以上の vRAM(NVIDIA または Apple Silicon)
ディスク	2 GB の空き + 文書とインデックス用	—

32 ビットシステムは非対応です(Ollama は 32 ビットビルドを提供していません)。UI には最新のブラウザ(Chrome、Firefox、Safari、Edge)を使います。

インストール

Fedora / RHEL

sudo dnf install ./docubrowser-foss-<VERSION>-<RELEASE>.noarch.rpm

Debian / Ubuntu / Mint

sudo apt install ./docubrowser-foss_<VERSION>-<RELEASE>_all.deb

任意の Linux(tarball)

tar xzf docubrowser-foss-<VERSION>-<RELEASE>.tar.gz
cd docubrowser-foss-<VERSION>-<RELEASE>
sudo ./install.sh

どの Linux の方法でも /opt/docubrowser/ に Python 仮想環境とともにインストールされ、CLI ラッパーが /usr/bin/docubrowser と /usr/bin/docuback に、デスクトップメニュー項目が Office の下に作成されます。

Windows

zip を展開して Install.bat をダブルクリックします。Python 3.9 以上と Ollama が事前にインストールされている必要があります。%USERPROFILE%\DocuBrowse にインストールされ、スタートメニューのショートカットが作られます。管理者権限は不要です。ショートカットが表示されるまで、一度ログアウトして再ログインが必要な場合があります。

macOS

dmg を開いて Install.command をダブルクリックします(スクリプトは未署名のため、初回は右クリック→開く)。Python 3.9 以上が必要です。~/Applications/DocuBrowse/ に CLI ラッパーと DocuBrowse.app ランチャーとともにインストールされます。

初回起動

docubrowser rescan   # 文書をスキャンしてインデックス化
docubrowser start    # サーバーを起動
docubrowser open     # ブラウザで UI を開く

start は Ollama がインストール・起動され、必要な両モデル(埋め込み用の nomic-embed-text:latest と要約用の dolphin3:latest)があるかを確認し、不足しているものをインストール・起動・取得します。

既定では文書ディレクトリは設定されていません。最初のスキャンの前に、Web UI の歯車アイコンをクリックするか、docubrowse.config に doc_dir を設定してください。

言語: DocuBrowse は英語で起動します。ターミナルでの最初の docubrowser start のときに、使いたい言語(英語、日本語、韓国語、簡体字または繁体字中国語)を尋ねられます。設定からいつでも変更できます。言語を参照。

前提条件

パッケージ版は requirements.txt から Python の依存関係を取り込みます。クローンしたリポジトリの場合は Python 3.9 以上と、次が必要です:

pdfplumber、pypdf:PDF 抽出
python-docx、python-pptx、openpyxl:Office ファイル
ebooklib、beautifulsoup4、mobi:電子書籍
striprtf:RTF(なければ .rtf はメタデータのみでインデックス化)
psutil:ハードウェア検出
Calibre:MOBI/AZW3/AZW に必須(sudo dnf install calibre または sudo apt install calibre)
libvisio-tools(任意):レガシーなバイナリ Visio ファイルの本文テキスト
DjVuLibre(任意):DjVu ファイルのテキスト
Ollama:なければ docubrowser start が自動でインストール

アンインストール

sudo dnf remove docubrowser-foss       # RPM
sudo apt remove docubrowser-foss       # DEB
sudo ./uninstall.sh                    # tarball

Windows:Uninstall.bat をダブルクリック。macOS:Uninstall.command をダブルクリック。

トラブルシューティング

Ollama が起動しない

ollama serve
ollama list
ollama pull nomic-embed-text:latest
ollama pull dolphin3:latest

スキャンの進行が止まって見える

tail -f /var/log/docubrowser.log
# または
tail -f ~/.local/share/docubrowser/docubrowser.log

inotify の監視上限

大規模なコレクションでは inotify watch limit reached がログに出ることがあります。無視して問題ありません。抑えるには /etc/sysctl.conf で fs.inotify.max_user_instances を 256 か 512 に上げ、sudo sysctl -p を実行します。

スキャンされた(画像のみの)PDF

プレースホルダーでインデックス化され ocr_list_pdfs.txt に記載されますが、OCR を実行するまで検索には一致しません。