shelf

# Shelf Shelfは、バーコードスキャン、AIによる写真取り込み、自動メタデータ検索、包括的なコレクション管理を単一のDockerコンテナに統合したセルフホスト型の家庭図書館カタログです。SQLiteデータベースを使用して完全に自分のネットワーク上で動作するため、データが自宅から出ることはありません。 ## 主な機能 ### スキャンとメタデータ - モバイル端末（iOSおよびAndroid）での**カメラによるバーコードスキャン**（ISBNおよびUPC対応）、USB/Bluetoothスキャナーもサポート - **8つのスキャンモード**: 追加、ウィッシュリスト、貸出、返却、移動、棚卸、検索、クイック評価 - **写真取り込み**: 棚の写真を撮影すると、ビジョンモデルが背表紙を読み取り、書籍、DVD、ビデオゲームを検出します。Anthropic API、OpenAI互換エンドポイント、または完全ローカルのOllamaモデルで動作します - Open Library（書籍）、TMDb（映画）、IGDB（ビデオゲーム）を横断する**タイトル検索** - Open Library、Hardcover、Google Books、各国の書誌（ドイツDNB、イタリアSBN）からの**カスケード型メタデータ検索** - カバーがないアイテムのレビューキューを備えた**カバーアートパイプライン** - **メディアタイプの検出**: バーコードがメディアタイプを判定します（ISBN = 書籍、ゲームUPC = ビデオゲームなど） - MusicBrainz経由でタイトルだけでなくリリース単位で**音楽をカタログ化**、トラックリストとプレス詳細付き - **定期刊行物**を出版物＋号のモデルとして管理 - **マンガ**を独立したメディアタイプとして管理 ### コレクション管理 - 管理者/閲覧者ロールを持つ**マルチユーザー** - ネストされた構成（部屋 → 本棚 → 棚）を持つ**ロケーション** - 個別の場所、状態、来歴を追跡する**物理コピー**管理 - 貸出リマインダー（ntfyまたはwebhook）付きの**貸出システム** - 欠番検出とウィッシュリスト連携を備えた**シリーズ追跡** - 一括適用と管理者管理が可能な**カスタムタグ** - **読書トラッキング**（読みたい、読書中、読了） - 年間読了数、コレクションの増加、時系列の価値チャートを表示する**統計ダッシュボード** - 月次/年次の読書まとめを共有可能な画像にする**ラップアップ** - 保険書類用のISBNdb経由の**評価レポート** - 復元機能と保持期間を備えた**ゴミ箱** - **CSVインポート/エクスポート**とポータブルアーカイブ（カバー付きzip） - Goodreads、StoryGraph、LibraryThing、Libibからの**移行** ### 技術的詳細 - **スタック**: FastAPI + SQLite + HTMX - **デプロイ**: 自動生成TLS証明書付きの単一Dockerコンテナ - **PWA**: オフライン書店モード - **設定**: 機能プロファイル（Minimal、Standard、Everything）と詳細なトグル - **セキュリティ**: 暗号化されたAPI認証情報、JWTセッション、個別の暗号化キー ## クイックスタート ```bash docker compose up -d ``` `https://localhost:18888` を開き、セットアップウィザードで管理者アカウントを作成します。 ## ドキュメント 完全なドキュメントは `docs/` ディレクトリにあり、インストール、設定、各機能のユーザーガイド、FAQ、トラブルシューティング、アーキテクチャを網羅しています。 ## ライセンス AGPL-3.0