withoutbg/withoutbg-python

解決する課題

Pythonで画像背景を削除する簡単な方法を提供します。ユーザーは、無料のプライベートなローカルモデルを実行するか、髪の毛や毛皮のような複雑なディテールに対してより優れた結果を得るために高品質なクラウドAPIを使用するかを選択できます。

仕組み

このライブラリは、2つの異なる実行パスに対して統一されたAPIを提供します。

• ローカルモード: Hugging FaceからダウンロードされたオープンウェイトのONNXモデル（約455 MB）を使用し、CPU上で動作します。DINOv3バックボーンを使用して、深度、セグメンテーション、マッティング、リファインメントを1回のパスで組み合わせます。
• クラウドモード: ローカルのハードウェアリソースを必要とせずに、プロフェッショナルグレードの品質を実現するために withoutBG Cloud API に接続します。

対象ユーザー

• 開発者: 自動化された背景削除を必要とするスクリプト、ノートブック、またはバックエンドを構築している方。
• プライバシーを重視するユーザー: 自身のマシンでのオフラインかつ無制限の処理を好む方。
• プロダクトビルダー: APIを介して商用アプリケーション向けの高精度な切り抜きを必要とする方。

ハイライト

• デュアルパスAPI: 1行のコードでローカル処理とクラウド処理を切り替え可能。
• CPUに最適化: ローカル推論はONNXを介してCPUで実行されるため、GPUは不要です。
• バッチ処理: モデルを一度だけロードして複数の画像を効率的に処理する remove_background_batch メソッドが含まれています。
• PIL統合: 画像をRGBAモードのPIL Image オブジェクトとして返すため、画像の合成やPNG/WebPとしての保存が容易です。
• CLIツール: コードを書かずに素早く背景を削除するためのコマンドラインインターフェースが含まれています。