Paper Reader

Read English papers without leaving the page: select any passage and get an instant Japanese translation + glossary + gist, streamed from a local LLM.

英語論文の PDF をブラウザで開き、分からない箇所を選択するとその場で 日本語訳＋用語解説＋主旨が右ペインにストリーム表示されるローカルツール。 コピー → 画面切替 → 貼付 → 復帰 の往復をなくすのが目的。

• 解説（選択テキストの翻訳・要約）はローカル完結。あなたのPC内で動く ローカルLLM（Ollama） が生成。APIキー・課金なし。 選択テキストは外部に送信されない。
• 質問機能（オプション）はクラウドLLM（Gemini / OpenAI / Anthropic）を使用。 論文本文と質問をクラウドに送信する。APIキーの設定が必要。 設定しなければこの機能は無効のまま。
• フロントエンドは pdf.js 等の CDN ライブラリを使用するため、 初回読み込みにインターネット接続が必要。
• 既定モデル qwen3.5:4b（ハイブリッド推論・~2.8GB、16GB Macで軽快）。 .env で変更可（高品質: qwen3:8b / 和訳の自然さ重視: gemma3:12b）。

配布版（DMG）は Apple Silicon 専用。Python ランタイム・依存パッケージ・ Ollama をすべて同梱しているので、ユーザーは何も別途インストールしなくてよい （管理者パスワードも不要）。初回だけモデルのダウンロードが走り、進捗はアプリ内に 表示される。以下のセットアップ手順はソースから動かす開発者向け。

セットアップ

1. ローカルLLM（Ollama・初回のみ）

Ollama サーバはバックグラウンド常駐させる（ターミナルを開きっぱなしにしない）。

推奨: 公式アプリ — https://ollama.com/download の .dmg を Applications に 入れて一度起動。以後メニューバー常駐＆ログイン時自動起動（ollama CLI も使える）。

または Homebrew:

brew install ollama
brew services start ollama   # launchd 常駐。再起動後も自動。ターミナル不要

どちらの方法でも最後にモデルを取得（初回のみ・約2.5GB）:

ollama pull qwen3.5:4b

配布版（DMG）は Ollama 本体を同梱し、アプリ専用のポートで起動するため、 この手順は不要（モデルは ~/.ollama/models を共有するので、既にモデルを 持っていれば再ダウンロードも起きない）。

2. アプリ本体

git clone https://github.com/nowex35/paper-reader.git
cd paper-reader
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env         # 通常は編集不要（既定で qwen3.5:4b）

Ollama 未起動 / モデル未取得でもアプリは壊れず、画面にセットアップ 手順が表示される。準備後にページ再読み込みで通常動作に切り替わる。

起動

A. ネイティブ窓で起動（推奨・ビルド不要・全環境）

source .venv/bin/activate
python desktop.py

専用ウィンドウで開く。Ollama が未起動なら自動で起動を試み、空きポートで 内蔵サーバを立てる（desktop.py が Ollama 確認 → FastAPI を空きポート起動 → pywebview のネイティブ窓で表示。窓を閉じると終了）。不具合時のログは .app.log。

B. アプリアイコンから（Dock に置きたい人向け・macOS）

.app は中のランチャが絶対パス固定で環境依存のためリポジトリには含めない。 clone した自分のマシンで一度だけ生成スクリプトを実行する:

./make_app.sh          # この clone の場所に合わせて Naruhodo.app を生成

生成された Naruhodo.app をダブルクリックで起動。ターミナル不要。 Dock に常駐させたい場合は /Applications か Dock にドラッグ （ランチャは生成時の絶対パス固定なので移動しても動く）。 リポジトリを別の場所へ移動・再 clone したら ./make_app.sh を再実行する。

C. 開発用（ブラウザ + ターミナル）

source .venv/bin/activate
python server.py

ブラウザで http://localhost:8432 を開く。

⚠️ 指定ポートが他プロセスに使われていると別サーバの応答が返ることがある。 空いているポート（例: 8010）を使う。使用中ポートの確認: lsof -nP -iTCP:8010 -sTCP:LISTEN

使い方

1. 「PDFを開く」or ドラッグ&ドロップで論文を表示
2. 分からない箇所をドラッグで選択
3. 選択横の 「解説」ボタン（または ⌘/Ctrl + E）→ 右ペインに訳と解説
4. 各カードの 「コピー(原文+解説)」 で Notion へそのまま貼れる形をコピー
5. ⌘/Ctrl + ] でズームイン、⌘/Ctrl + [ でズームアウト、⌘/Ctrl + 0 でリセット （Ctrl + ホイール / ピンチでも操作可）

メモ機能（自分の言葉でまとめて理解を深める）

すべて 1 画面で完結（タブ遷移・別ページなし）。ChatGPT のような構成。

読んだ論文の一覧 — 左サイドバー

• 上部 「☰ 一覧」 でサイドバーを開閉（状態は記憶。「«」でも閉じる）
• 全メモを更新日順に表示。タイトル/PDF名で絞り込み、件数表示
• 項目クリック → そのメモを下部「このメモ」に読み込み（PDF を開かなくても 読み返し・再編集できる）。選択中はハイライト。各項目ホバーで「×」削除
• 保存・削除はサイドバーへ即時反映

読みながら書く — 下部メモパネル

• 上部 「📝 メモ」 で開閉（⌘/Ctrl+S でも開いて保存）。上端ドラッグで高さ調整
• タイトル＋自由本文（Markdown可）。入力すると自動保存、 「プレビュー」 で整形表示
• 論文の同定は PDF 内容ハッシュなので、同じ論文を開けば （ファイル名を変えても）前回のメモが自動で復元される

保存先は notes/<slug>-<id>.md（frontmatter 付き Markdown）。 ツール外からも読め、git で履歴管理でき、ブラウザを消しても残る。

設定

項目	場所	既定
モデル	.env の OLLAMA_MODEL	qwen3.5:4b
Ollama エンドポイント	.env の OLLAMA_HOST	http://localhost:11434
解説の構成・口調	server.py の SYSTEM_INSTRUCTION	訳／用語／主旨の3節

解説はすべてローカルの Ollama で生成され、選択テキストは外部に送信されない。 質問機能を使う場合は .env に ASK_PROVIDER / ASK_API_KEY を設定する （論文本文がクラウドLLMに送信される点に注意）。

リリース

v* タグを push すると GitHub Actions が署名・公証済み DMG をビルドし、 GitHub Release にアップロードする。

git tag v1.2.0
git push origin v1.2.0

今後の拡張候補（未実装）

• pdf.js 等をローカル同梱して完全オフライン化
• 解説カードのエクスポート機能（Markdown / クリップボード整形の拡充）

ライセンス

MIT License © 2026 Hayate Aizawa