mcpField
I
imgen

imgen

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

imgen について

imgenは、Azure OpenAIで画像の生成、編集、説明を行うCLIです。出力設定やプリセットを指定でき、実行前に設定を確認できます。

主な機能

  1. 01サイズと品質を指定した画像生成
  2. 02自然言語での画像編集
  3. 03複数言語での画像説明
  4. 04組み込みプリセットとコンテキストファイル
  5. 05dry-runによる設定確認

活用シーン

  1. 01イラスト、商品写真、下書きの作成
  2. 02画像の背景やスタイルの変更
  3. 03スクリーンショットや図表の説明取得

インストール

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

$npx skills add https://github.com/nogataka/slidekit --skill imgen

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

詳細

プロジェクトの README より

imgen - Azure OpenAI Image Generation CLI

How to Run

imgen is NOT globally installed. Use one of these methods:

# 開発モード（ソースから直接実行、.envを自動読み込み）
npm run dev --prefix /Volumes/Data/dev/imgen -- <command>

# npx でソースから実行（.envは自動読み込みされない）
npx tsx /Volumes/Data/dev/imgen/src/index.ts <command>

# npm パッケージとして実行（npm install -g @nogataka/imgen 済みの場合）
imgen <command>

以下の例では imgen と表記するが、実際は上記いずれかの方法で実行すること。

Quick Reference

imgen image gen "<prompt>" -q <quality> -s <size>    # 画像生成
imgen image edit <file> "<instruction>"               # 画像編集
imgen image explain <file> -l <lang>                  # 画像説明

Setup

環境変数または .env ファイルで Azure OpenAI の認証情報を設定する。

# 環境変数（最優先）
export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com"
export AZURE_OPENAI_API_KEY="your-api-key"
export AZURE_OPENAI_DEPLOYMENT_NAME="gpt-5.1"
export AZURE_OPENAI_DEPLOYMENT_NAME_IMAGE="gpt-image-1.5"

.env ファイル探索順: cwd/.env → ~/.imgen/.env

VariableDescriptionDefault
AZURE_OPENAI_ENDPOINTAzure OpenAI resource endpoint(required)
AZURE_OPENAI_API_KEYAzure OpenAI API key(required)
AZURE_OPENAI_DEPLOYMENT_NAMEChat model deployment(required)
AZURE_OPENAI_DEPLOYMENT_NAME_IMAGEImage model deployment(required)
AZURE_OPENAI_API_VERSIONChat API version2024-02-15-preview
AZURE_OPENAI_IMAGE_API_VERSIONImage API version2025-04-01-preview

Image Generation

imgen image gen [options] <theme>
OptionValuesDefault
-s, --size1024x1024, 1536x1024, 1024x15361024x1024
-q, --qualitylow, medium, highhigh
-f, --formatpng, jpg, webppng
-p, --presetbuiltin preset name-
-c, --contextcontext file path (.md/.txt)-
-o, --outputoutput path (file or directory)auto
-d, --debugenable debug loggingfalse
--jsonJSON output formatfalse
--dry-runpreview settings without API callfalse
Recommended Settings
Use CaseQualitySize
Product photo, landscapehigh1536x1024
Illustration, icon, mascothigh1024x1024
Quick draft, prototypelow1024x1024
Portrait, verticalhigh1024x1536
Examples
imgen image gen "夕日の海辺の風景" -q high -s 1536x1024
imgen image gen "可愛い猫のマスコット" -p builtin:square
imgen image gen "ミニマルなロゴデザイン" -o logo.png
imgen image gen "complex scene" --dry-run

Image Editing

imgen image edit [options] <file> <prompt>

Edit instructions in natural language:

  • Background change: "背景を青空に変更"
  • Style transfer: "水彩画風に変換"
  • Object modification: "色を鮮やかに"

Supported input formats: .jpg, .jpeg, .png, .gif, .webp

OptionValuesDefault
-s, --size1024x1024, 1536x1024, 1024x15361024x1024
-f, --formatpng, jpg, webppng
-o, --outputoutput pathauto
--jsonJSON output formatfalse
--dry-runpreview settings without API callfalse
Examples
imgen image edit photo.jpg "背景を青空に変更"
imgen image edit portrait.png "アニメスタイルに変換" -s 1536x1024
imgen image edit photo.png "edit" --dry-run

Image Explanation

imgen image explain [options] <file>
OptionValuesDefault
-l, --langja, en, zh, ko, es, fr, de, it, ru, vija
-f, --formatmarkdown, jsonmarkdown
-c, --contextcontext info (text or .md/.txt file path)-
-o, --outputoutput file pathstdout
Examples
imgen image explain screenshot.png
imgen image explain photo.jpg -l en
imgen image explain chart.png -c "Q4 sales report" -f json

Builtin Presets

-p オプションで指定可能:

NameSizeQuality
builtin:square1024x1024high
builtin:landscape1536x1024high
builtin:portrait1024x1536high
builtin:draft1024x1024low
builtin:photo1536x1024high

Option Priority

CLI options > Preset values (-p) > Default values

コメント

Markdown 対応