Xueyang-Song/paper-pilot
Research-paper workflow tool for literature triage and structured reading
Paper Pilot – ローカル優先のAI駆動型研究アシスタント
何であるか – Paper Pilot は科学者が学術論文を収集、保存、統合するのを支援するデスクトップアプリ（Electron + React）です。複数のオープンアクセス学術データベースをクロールし、PDFをダウンロードし、テキストに変換して、全文検索およびベクトル検索でインデックス化し、ローカルまたはホストされたLLM（例：Ollama、OpenAI互換API）に自然言語で質問できます。すべてのデータはあなたのマシン上に留まります。リモートモデルにリクエストを送信する場合を除き、データは外部に送信されません。
コア機能
| 機能 | 動作方法 |
|---|---|
| マルチソースクローリング | OpenAlex、Crossref、Semantic Scholar、PubMed/PMC、arXiv、Europe PMC、CORE、Unpaywall、および実験的なGoogle Scholarスクリーパーを含む8つ以上のソースを同時に問い合わせます。 |
| PDF → 知識パイプライン | Unpaywall経由でオープンアクセスPDFを取得し、MarkItDownツールでMarkdownに変換し、SQLiteデータベースにテキストを保存します。 |
| ローカルストレージ＆検索 | キーワード検索にはSQLiteの組み込みFTS5エンジン、ベクトル類似度検索にはsqlite‑vec拡張機能を使用。プロジェクトは分離されているため、異なる研究コンテキストを別々に管理できます。 |
| AI支援による統合 | ユーザーの質問と関連する抽出された文章を、ローカルのOllamaモデルまたは任意のOpenAI互換エンドポイントに送信します。ストリーミングチャット、"根拠付き"モード（出典にたどり着ける情報のみ返す）、"探索的"モード（より推測的な回答を許可）をサポートします。 |
| 検証可能な証拠レビュー | すべての回答は正確な出典にリンクされており、UIでは推論のトレースを表示し、AIの提案を受け入れ／拒否できます。また、再現可能な証拠パッケージ（RIS、BibTeX、CSV）をエクスポートできます。 |
| セキュアな資格情報 | APIキーはElectronのsafeStorage APIを使用して暗号化され、ディスク上に保存されます。 |
アーキテクチャの概要
paper‑pilot/
├─ src/electron/ # Node.jsメインプロセス
│ ├─ crawlers/ # 各学術API用のアダプタ
│ ├─ db/ # SQLite + FTS5 + sqlite‑vecレイヤー
│ ├─ agent/ # LLMオーケストレーション（ツールコール、ストリーミング）
│ └─ python/ # MarkItDown変換およびPlaywrightブリッジ
├─ src/renderer/ # React 19 UI（Vite、Tailwind、TanStack Query）
│ ├─ workspace/ # チャットインターフェース
│ ├─ projects/ # プロジェクト管理
│ ├─ artifacts/ # 論文リストとPDFビューアー
│ └─ settings/ # APIキー、ポリシー、モデル選択
└─ tests/ # Vitestテストスイート
スタックは完全にオープンソースです：TypeScript 5、React 19、Vite、SQLite、およびPDF処理用の軽量Python環境。
クイックスタート
# 1. クローン
git clone https://github.com/Xueyang-Song/paper-pilot.git
cd paper-pilot
# 2. Node依存関係のインストール
npm install
# 3. 開発サーバーの起動（UIは http://127.0.0.1:5173 で開く）
npm run dev
# 4. プロダクションバンドルのビルド
npm run build
# 5. ネイティブデスクトップアプリとしてパッケージ化（macOS/Linux – まだテスト未完了）
npm run package
前提条件：Node ≥ 22.18、Python 3.11+、およびローカルLLM推論を完全にオフラインで行いたい場合はOllama（オプション）。
誰が恩恵を受けるか？
- 複数のリポジトリから文献を収集する必要がある研究者
- すべての主張が特定の論文にリンクされる再現可能な監査トレースを望む文献レビュー担当者
- データプライバシー規則が厳しいチーム（すべてのPDFと埋め込みはローカルディスク上に留まる）
- ローカルLLM（Ollama）を学術Q&Aに試している誰も
現在の成熟度
- コアクローラー、SQLiteインデックス、AIチャットワークスペースは安定とマークされています。
- Google‑Scholarスクリーパーは実験的です。
- macOS/Linuxパッケージングは完全にテストされていません。クラウド同期連携は計画されていません。
コントリビューション
リポジトリには完全なVitestテストスイート、Lint、型チェックスクリプトが含まれています。貢献を歓迎します。大規模なPRを行う前に、まずIssueを開いてください。保護されたブランチワークフローとリリースラベルについてはCONTRIBUTING.mdを参照してください。
TL;DR
Paper Pilotは学術データソースのクローリング、ローカルPDFのインジェスト、検索可能なSQLiteストレージ、LLM駆動のチャットインターフェースを1つのデスクトップアプリに統合し、あなたのデータをプライベートに保ちます。クラウドに研究データを移動せずにAIアシスタンスを活用したい科学者にとって実用的なツールです。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト