mcpField
I
image-upscale

image-upscale

github.com/agntswrmクリエイティブ・メディア646 回インストール34 週間前に更新
リポジトリ

image-upscale について

image-upscale は、AI 超解像モデルで画像を拡大するコマンドラインスキルです。ファイルパスや URL を入力でき、ローカルとホスト型のプロバイダーを選べます。

主な機能

  1. 012x または 4x の拡大
  2. 02Transformers.js によるローカル CPU 処理
  3. 03fal と Replicate のプロバイダー対応
  4. 04モデルと出力先の指定

活用シーン

  1. 01ローカルファイルの画像拡大
  2. 02URL で指定した画像の拡大
  3. 03拡大処理に使うプロバイダーの選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/agntswrm/agent-media --skill image-upscale

インストール後、Claude Code で/image-upscaleを入力して読み込まれたか確認します。

詳細

画像のアップスケール

AI 超解像モデルを使用して画像をアップスケールし、リアルなディテールを生成しながら解像度を高めます。

コマンド

npx agent-media@latest image upscale --in <path> [options]

入力

オプション必須説明
--inはい入力ファイルのパスまたは URL
--scaleいいえ拡大率（2 または 4、デフォルト：2）
--outいいえ出力先のパス、ファイル名、またはディレクトリ（デフォルト：./）
--providerいいえ使用するプロバイダー（local、fal、replicate）
--modelいいえ使用するモデル（プロバイダーのデフォルトを上書きします）

出力

アップスケールした画像のパスを含む JSON オブジェクトを返します。

{
  "ok": true,
  "media_type": "image",
  "action": "upscale",
  "provider": "local",
  "output_path": "upscaled_123_abc.png",
  "mime": "image/png",
  "bytes": 456789
}

例

画像をアップスケールします（デフォルトの 2 倍）。

npx agent-media@latest image upscale --in photo.jpg

特定のプロバイダーを指定して 4 倍にアップスケールします。

npx agent-media@latest image upscale --in photo.jpg --scale 4 --provider fal

出力先を指定してアップスケールします。

npx agent-media@latest image upscale --in photo.jpg --out ./upscaled

プロバイダー

local

Transformers.js を使用して CPU 上でローカルに実行します。API キーは不要です。

  • Xenova/swin2SR-compressed-sr-x4-48 モデルを使用します（約 1.3MB）。
  • --scale の値にかかわらず、常に 4 倍にアップスケールします（モデルアーキテクチャの制限によるものです）。
  • 初回使用時にモデルがダウンロードされます。
  • mutex lock failed エラーが表示されることがありますが、"ok": true であれば出力は正しいため、無視してください。
npx agent-media@latest image upscale --in photo.jpg --provider local
fal
  • FAL_API_KEY が必要です。
  • fal-ai/esrgan（Real-ESRGAN）モデルを使用します。
  • 2 倍および 4 倍の拡大に対応しています。
replicate
  • REPLICATE_API_TOKEN が必要です。
  • nightmareai/real-esrgan モデルを使用します。
  • 2～10 倍の拡大に対応しています。

コメント

Markdown 対応