giuseppe99barchetta/SuggestArr

🚀 SuggestArr – AI を活用したメディアレコメンデーションとリクエスト自動化

SuggestArr は、家庭で Jellyfin、Plex、または Emby でストリーミングしている内容を監視し、類似タイトルを自動的に提案して、Seer（メディアリクエストマネージャー）にダウンロードリクエストを送信するオープンソースサービスです。TMDb または OpenAI 互換の大規模言語モデルからレコメンデーションを取得でき、短い理由付きの AI 生成提案を得られます。

---

コア機能

機能	説明
視聴履歴ソース	Jellyfin、Plex、Emby から最近の再生を読み取ります。オプションでユーザーごとの Trakt 同期。CSV または手動 TMDb リストのインポートも可能。
レコメンデーションエンジン	TMDb の類似性 API または OpenAI 互換の LLM（OpenAI、Ollama、OpenRouter、LiteLLM など）を使用して、短い自然言語の理由付きのタイトルリストを生成します。
AI 検索	見たい内容の自由形式の説明を入力すると、SuggestArr が LLM にクエリし、ワンクリックで一致するタイトルを返します。
公開リストインポート	MDBList または Trakt からスケジュールまたはオンデマンドでリストを取得します。
リクエストワークフロー	選択したタイトルを Seer に送信します。手動承認を要求したり、Seer に保留中のリクエストがある場合は一時停止したり、古いリクエストを自動拒否したりできます。
クリーンアップ自動化	お気に入りに登録されなかった SuggestArr 生成リクエストを定期的に削除します（デフォルトはドライラン）。
フィルター	自国でストリーミングサービスで利用可能なコンテンツをスキップし、品質制限を尊重し、ユーザーごとのフィルターを適用します。
Web UI	セットアップウィザード、スケジューリング、ユーザー管理、ライブログ、接続テスト—すべてブラウザからアクセス可能。
レキャップとマイルストーン	提案/追加された内容の共有可能な要約を生成します。
データベースバックエンド	すぐに使える SQLite。大規模なインストールにはオプションで PostgreSQL または MySQL。
公開 REST API	外部統合用の Swagger UI 付きの安定した /api/v1 エンドポイント。

---

技術スタックと要件

• Docker（推奨）またはプレーンな Python 3 環境。
• TMDb API キー（無料登録）。
• サポートされているメディアサーバーのいずれか（Jellyfin / Plex / Emby）。
• Seer（リクエスト処理サービス）—このツールはリクエストを作成するだけで、メディア自体をダウンロードしません。
• オプション：PostgreSQL/MySQL、OpenAI 互換の LLM エンドポイント、Trakt アプリ認証情報。

---

クイックスタート（Docker Compose）

services:
  suggestarr:
    image: ciuse99/suggestarr:latest   # ghcr.io/giuseppe99barchetta/suggestarr としても利用可能
    container_name: SuggestArr
    restart: always
    ports:
      - "${SUGGESTARR_PORT:-5000}:${SUGGESTARR_PORT:-5000}"
    volumes:
      - ./config_files:/app/config/config_files
    environment:
      - LOG_LEVEL=${LOG_LEVEL:-info}
      - SUGGESTARR_PORT=${SUGGESTARR_PORT:-5000}

docker compose up -d

その後、http://localhost:5000 を開き、Web ベースのセットアップウィザードに従ってください。

---

拡張と統合

• API – すべての外部ツールは安定した /api/v1 エンドポイントを呼び出すことができます。Swagger UI は /docs で利用可能です。
• LLM プラグイン – OPENAI_API_BASE（または同等）環境変数を互換性のあるモデルを指すように設定します。SuggestArr は AI 駆動のレコメンデーションと検索にそれを使用します。
• データベース移行 – 設定ファイルの接続文字列を更新して SQLite から PostgreSQL/MySQL に切り替えます。スキーマは自動的に管理されます。

---

コミュニティとサポート

• Discord：https://discord.com/invite/JXwFd3PnXY
• 寄付：Ko-fi と Buy-Me-a-Coffee リンク（任意サポート用）。
• 貢献：問題とプルリクエストを歓迎します。リポジトリには詳細なインストール、機能、API ガイドが含まれています。

---

ライセンス

MIT – 自由に使用、変更、再配布できます。

---

結論：SuggestArr は、既存のメディアサーバー、TMDb（または任意の LLM）、Seer を結び付け、受動的な視聴履歴を能動的な AI 強化の視聴提案と自動化されたリクエスト処理に変えます。すべてクリーンな Web UI または公開 REST API で制御できます。