Slimsam 77 Uniform

🚀 スリムSAM-77ユニフォームモデルのTransformers.js対応版

このリポジトリは、nielsr/slimsam-77-uniformモデルをTransformers.jsと互換性のあるONNXウェイトで提供します。

🚀 クイックスタート

https://huggingface.co/nielsr/slimsam-77-uniform のモデルを、Transformers.jsと互換性のあるONNXウェイトで利用できます。

📦 インストール

まだの場合、Transformers.js JavaScriptライブラリをNPMから以下のコマンドでインストールできます。

npm i @huggingface/transformers

💻 使用例

基本的な使用法

Xenova/slimsam-77-uniform を使ってマスク生成を行う例です。

import { SamModel, AutoProcessor, RawImage } from '@huggingface/transformers';

// モデルとプロセッサーをロード
const model = await SamModel.from_pretrained('Xenova/slimsam-77-uniform');
const processor = await AutoProcessor.from_pretrained('Xenova/slimsam-77-uniform');

// 画像と入力ポイントを準備
const img_url = 'https://huggingface.co/datasets/Xenova/transformers.js-docs/resolve/main/corgi.jpg';
const raw_image = await RawImage.read(img_url);
const input_points = [[[340, 250]]];

// 入力を処理してマスク生成を実行
const inputs = await processor(raw_image, { input_points });
const outputs = await model(inputs);

// マスクを後処理
const masks = await processor.post_process_masks(outputs.pred_masks, inputs.original_sizes, inputs.reshaped_input_sizes);
console.log(masks);
// [
//   Tensor {
//     dims: [ 1, 3, 410, 614 ],
//     type: 'bool',
//     data: Uint8Array(755220) [ ... ],
//     size: 755220
//   }
// ]
const scores = outputs.iou_scores;
console.log(scores);
// Tensor {
//   dims: [ 1, 1, 3 ],
//   type: 'float32',
//   data: Float32Array(3) [
//     0.8350210189819336,
//     0.9786665439605713,
//     0.8379436731338501
//   ],
//   size: 3
// }

生成されたマスクを可視化するには、以下のコードを使用します。

const image = RawImage.fromTensor(masks[0][0].mul(255));
image.save('mask.png');

次に、最も高いIoUスコアを持つチャンネル（この場合は2番目の緑色のチャンネル）を選択します。これを元の画像と交差させると、対象物の分離されたバージョンが得られます。

📚 ドキュメント

デモ

オンラインデモも用意しています。こちらから試すことができます。

⚠️ 重要提示

WebMLがより普及するまで、ONNXウェイト用に別のリポジトリを用意するのは一時的な解決策です。モデルをWeb対応にする場合は、🤗 Optimumを使ってONNXに変換し、このリポジトリのように構成することをおすすめします（ONNXウェイトは onnx というサブフォルダに配置）。