Lastbook — オフラインで動作する地図・資料・AI検索ライブラリ
Immortal-Protocols/lastbook
★ 1,825 ・ Python ・ MIT
概要
Lastbookは、Mac、Windows、Linux向けに提供されているオフライン対応のサバイバルライブラリ環境です。災害時や通信インフラが遮断された環境、あるいは通信が制限された状況下での活動・再建を想定し、各種マニュアル、PDF、動画、百科事典、オフライン地図、実践的なガイドラインを1台のPC上に集約します。
初回セットアップで必要なデータパックをダウンロードした後は、完全にオフラインで動作します。デスクトップアプリのサイドバーから動画、地図、チャットUIを呼び出すことができ、チャット機能では手元のライブラリを参照しながら出典元へのリンク付きで質問に回答します。通信環境が不安定な現場で信頼できる情報源を手元に保持したい開発者やフィールドワーカー、プライバシーを重視して外部通信を行わない知識ベースを構築したい人に向いています。
主な特徴
- 目的別の実践ガイドと包括的な資料ライブラリ
緊急度の高いニーズに対応する短いガイド群(
content/topics/)が用意されており、ライブラリ内の該当ページ番号を明示します。マニュアルやPDF全体の閲覧機能、動画再生、ZIM形式のオフライン百科事典に対応し、全文キーワード検索が可能です。Windows環境では意味ベース(セマンティック)の検索もサポートされています。 - 住所検索が可能なオフライン地図 世界および全米のベースマップに加え、セットアップ時に指定した米国の特定州の詳細マップ(道路、建物、地形、農地、水源、救援・リソース拠点情報など)を保持できます。州内の住所検索もオフラインで完結し、位置情報の自動取得(測位)は行われません。
- ローカル動作する出典付きAIアシスタント PC内のローカル環境で動作するAIモデル(LLM)に対して自然言語で質問し、ライブラリ内の該当ページを引用した回答を取得できます。PCのスペックが不足している場合やモデルを導入しない場合でも、チャットUI経由で適切な資料ページを検索する機能は利用可能です。
- ポートを開かないインメモリ通信アーキテクチャ デスクトップアプリは外部やローカルのネットワークポート(リスニングポート)を一切開きません。UIとエンジン間の通信は、OSネイティブのWebViewが備えるインメモリブリッジ(WKURLSchemeHandler、WebView2、WebKitGTK)を利用し、ローカルAIランナーとも標準入出力(stdin/stdout)のJSON Linesでやり取りを行います。
- 厳格なネットワーク制御と安全性検証 ネットワーク接続はユーザー自身が明示的に実行する「初回セットアップのダウンロード」と「手動での更新確認」の2種類に限定されています。通信は許可リストに登録されたホストへのHTTPS(ポート443)のみに制限され、OSの証明書ストアではなく同梱された信頼ルート証明書(Mozillaのバンドルから抽出した11個)のみを使用します。取得したファイルはSHA-256でハッシュ検証され、ZIP展開時のパストラバーサル検証も実施されます。
- ブラウザ共有可能なライブラリサーバー機能 デスクトップ単体での利用だけでなく、同一Wi-Fiネットワーク上のスマートフォンや他端末とライブラリを共有できるサーバー実行モードも備えています。
使い方
Linux (Ubuntu) でのインストール
Linux向けには、Ubuntu 24.04 LTSおよび26.04 LTS(x86_64)用のdebパッケージが用意されています。
# Ubuntu 24.04 の場合
sudo apt install ./Lastbook_1.1.11_amd64.deb
# Ubuntu 26.04 の場合
sudo apt install ./Lastbook_1.1.11_ubuntu26.04_amd64.deb
インストール後、アプリケーションメニューから起動します。本体ファイルは /opt/lastbook に配置され、ダウンロードされたライブラリや設定情報はユーザーのホームディレクトリに保存されます。
ソースコードからの実行
ソースコードから直接実行する場合は、Python 3.11以上とライブラリデータ用フォルダが必要です。
# 仮想環境の作成と依存関係のインストール
python3 -m venv .venv
.venv/bin/pip install -r packaging/requirements_macos.txt # Windowsの場合は packaging/requirements_app.txt
# アプリの起動(データフォルダを指定)
.venv/bin/python app/main.py --data /path/to/LastbookData
--data を指定しない場合、環境変数 LASTBOOK_DATA や前回の選択パス、内部のデータフォルダが参照されます。利用可能なライブラリが存在しない場合は、初回セットアップ画面が立ち上がります。
ライブラリサーバーの起動
ブラウザからエンジンを利用し、同一ローカルネットワーク上の端末と共有する場合は、以下のコマンドで起動します。
LASTBOOK_DATA=/path/to/LastbookData python3 server.py
起動後、ブラウザで http://127.0.0.1:8890/ にアクセスします。
技術的なポイント
Lastbookの設計において際立っているのは、オフライン性とセキュリティを両立させるための徹底した実装分離です。
- フロントエンドとバックエンドの構成
UI部分はプレーンなHTML、CSS、JavaScript(
web/配下)で構築されており、Node.jsなどのビルドステップを介さず、外部Webリソースへの読み込みもブロックされています。エンジン側はPythonで実装されており、リクエスト処理、検索処理、PDF処理(macOS向けにはpypdfium2を内包)、更新チェック機能が組み合わされています。 - OS標準のWebViewブリッジ機構
ローカルHTTPサーバーを常駐させてポートを開く構成を避け、macOSでは
WKURLSchemeHandler(app/shell_macos.py)、WindowsではWebView2のWebResourceRequested(app/shell_windows.py)、LinuxではWebKitGTKのURISchemeRequest(app/shell_linux.py)を用いて、インメモリでリクエストとレスポンスを仲介しています。 - ローカルAIプロセスの隔離
ローカルLLMの推論エンジンはソケットを開かず、標準入出力上のJSON Lines形式(
packaging/llm/、llm_local.py)で通信を制御しています。マシンスペックに応じた動作適合性判定(fit check)やモデルピン留めの仕組みも備えています。 - アトミックなデータ更新処理 データパックのダウンロード時は、既存のライブラリに直接上書きせず、並行して解凍・検証を行ったうえで単一のリネーム処理によって差し替えます。解凍や検証の段階で問題が発生した場合でも、既存のライブラリ環境が破損しないようフェイルセーフな設計になっています。
注意点
- 対応環境とプラットフォームの制約 デスクトップ版は macOS 14以降(Apple Silicon)、Windows 10以降(64-bit)、Ubuntu 24.04/26.04 LTS(x86_64)がサポート対象です。Linux版のGPU活用や他ディストリビューションでの動作は現時点では検証されておらず、テストはWSL2上のCPU環境で実施されています。
- iPad版の位置づけ
mobile/ipad/配下にiPad向けアプリのソースコードが含まれていますが、これはコントリビューターが各自でビルド・署名を行うためのプレビュー版です。App StoreやTestFlightでの配布は行われていません。 - ライセンスとデータサイズ LastbookのオリジナルコードおよびドキュメントはMITライセンスで提供されています。ただし、初回セットアップでダウンロードするデータパック(Small、Medium、All)や各種マップデータ、AIモデルは相応のストレージ容量とダウンロード時間を必要とするため、運用前の十分な空き容量確保が必要です。
まとめ
Lastbookは、ネットワークが使えない極限状況でも確実な情報アクセスを維持できるよう、徹底したローカルファースト原則で設計された総合知識ライブラリです。ポートを開かないWebViewブリッジや厳格な通信制御など、セキュリティと堅牢性に配慮されたアーキテクチャが特徴となっています。





