samyost1/3dicon

何がそれか

/3dicon は、自然言語のプロンプトをループするアニメーション3Dアイコン（実際のアルファ透明度を備えたWebPとしてエクスポート）に変換する、小型で自己ホスト可能なツールです。Claude風のプラグインから呼び出すか、コマンドラインから使用できるように設計されており、UIに直接ドロップできるアセットを生成します。

動作方法

1. プロンプト → 静止画像 – ユーザーのテキストは OpenRouter を介して画像生成モデル（GPT Image と呼ばれる）に送られ、3Dスタイルの単一画像が生成されます。
2. 最初と最後のフレーム – 同じ静止画像が、短い動画クリップの最初と最後のフレームとして使用されます。
3. 動画モデル – 動画生成モデル（Seedance と名付けられた）が中間フレームを作成し、動きが元の静止画像に戻るように保証します。
4. マッティング – 各フレームは、既知の色の背景を除去するマッティングモデルを通過させ、元の色を正確に再構築し、クリーンでソフトなエッジを実現します。
5. エクスポート – 処理されたフレームがアニメーションWebPに組み立てられ、真の透明度を保持します。

鍵となるテクニックは、静止画像を開始と終了の両方で再利用することにより、動画モデルがシームレスなループを生成するように強制することです。

インストール手順

# プラグインを Claude/アシスタント環境に追加
/plugin marketplace add samyost1/3dicon
/plugin install 3dicon

# スキルをローカルにクローン（表示されるパスは Claude がスキルを保存する場所です）
cd ~/.claude/skills/3dicon
pip install -r requirements.txt   # Python依存関係をインストール
cp .env.example .env               # 環境テンプレートをコピー

.env を編集し、OpenRouter APIキーを挿入します：

OPENROUTER_API_KEY=sk-or-…

システムの PATH に ffmpeg が利用可能であることを確認してください。初回実行時に約180MBのマッティングモデルもダウンロードされます。

ツールの使い方

Claudeチャット（またはプラグインにコマンドを転送する任意のインターフェース）から、単純な言葉で要求します。たとえば：

make an animated 3d fire icon using /3dicon

ワークフローはインタラクティブです：

1. システムが静止画像を生成し、表示します。
2. 静止画像を確認します（動きの料金は、結果に満足した場合にのみ発生します）。
3. その後、アニメーションの動きを提案します。再度確認します。
4. 最終的なアニメーションWebPが返されます。

ライセンスと所有権

コードは MIT ライセンスの下でリリースされています。生成したアイコンは、追加制限なしにあなたが所有します。

---

上記のすべての詳細は、リポジトリの README から直接取得されています。