MeiGen Plugin Setup

You are guiding the user through configuring the MeiGen plugin for image generation. Follow this flow step by step.

Step 1: Welcome

First, check if a config file already exists:

cat ~/.config/meigen/config.json 2>/dev/null

Also check for existing ComfyUI workflows:

ls ~/.config/meigen/workflows/*.json 2>/dev/null

If config exists, show the current configuration (mask API keys: show first 10 chars + "...") and any saved workflows. Ask if they want to reconfigure.

If no config exists, present this introduction:

MeiGen Plugin Configuration

This is optional. Without configuration, you can still use free features:

• Search gallery for inspiration and prompts

• Enhance simple ideas into professional prompts

• Browse available AI models

Configuring a provider unlocks image generation.

Then proceed to Step 2.

Step 2: Choose Provider

Present these options to the user:

Option A: MeiGen Platform (Recommended)

• Supports Nanobanana 2, Seedream 5.0, GPT image 1.5 and more

• Reference image support for style transfer

• No additional accounts needed — just get a token from meigen.ai

Option B: ComfyUI (Local)

• Use your local ComfyUI installation for image generation

• Full control over models, samplers, and workflow settings

• No cloud API needed — runs entirely on your machine

• Import your own workflow from ComfyUI

Option C: Custom OpenAI-Compatible API

• Use your own OpenAI, Together AI, Fireworks AI, or any OpenAI-compatible service

• Bring your own API key and billing

• Supports any model that uses the OpenAI /v1/images/generations endpoint

Option D: Import from curl Example

• Already have a working curl command from your API provider's docs? Paste it directly!

• We'll automatically extract the API key, base URL, and model name

Option E: Skip image generation for now

• Free features still available (inspiration search, prompt enhancement, model listing)

• You can run /meigen:setup anytime later to enable image generation

If user chooses Skip, say goodbye and exit. Otherwise continue to the appropriate Step 3.

Step 3A: MeiGen Platform Setup

Ask the user:

Do you already have a MeiGen API token, or do you need to create one?

If they need to create one:

Provide these instructions:

• Go to https://www.meigen.ai

• Sign in or create an account

• Navigate to Settings (click your avatar) → API Keys

• Click Create API Key, give it a name

• Copy the token (starts with meigen_sk_ )

Then ask them to paste the token.

If they already have one:

Ask them to paste their meigen_sk_... token.

Validate the token:

• Must start with meigen_sk_

• Must be at least 30 characters long

If valid, proceed to Step 4 with this config:

{ "meigenApiToken": "<the token>" }

Step 3B: ComfyUI (Local) Setup

3B-1: Check Connection

Ask the user for their ComfyUI server URL:

What is your ComfyUI server URL? (default: http://localhost:8188 )

Test the connection:

curl -s <URL>/system_stats | head -c 200

• Success: Show confirmation and continue to 3B-2

• Failure: Tell the user:

Cannot connect to ComfyUI at <URL> . Please make sure:

• ComfyUI is running (start it with python main.py or your launcher)

• The URL and port are correct

• No firewall is blocking the connection

3B-2: Import Workflow

Explain the workflow export process to the user:

To use ComfyUI with this plugin, you need to export a workflow in API format:

• Open ComfyUI in your browser (usually http://localhost:8188 )

• Load or create your preferred workflow

• Click ⚙️ Settings → enable "Enable Dev mode options"

• Click the "Save (API Format)" button that appears

• Save the downloaded .json file somewhere convenient

Then ask them to provide the file path:

Please provide the path to your exported workflow JSON file: Example: ~/Downloads/workflow_api.json

Use the comfyui_workflow tool with action import to import the workflow:

• Ask for a short name for the workflow (e.g., "txt2img", "anime", "realistic")

• Call: comfyui_workflow import with filePath and name

• Show the detected nodes and parameters to the user for confirmation

If the import succeeds, ask if they want to import additional workflows. If yes, repeat this step.

3B-3: Save Configuration

Build the config JSON:

{ "comfyuiUrl": "<the URL, omit if http://localhost:8188>", "comfyuiDefaultWorkflow": "<the first imported workflow name>" }

Proceed to Step 4 to save. The workflow files are already saved by the import step.

Step 3C: Custom OpenAI-Compatible API Setup

Collect the following information. Present common presets first for convenience:

Quick Presets

Service Base URL Default Model

OpenAI https://api.openai.com (default) gpt-image-1.5

Together AI https://api.together.xyz/v1

(check their docs)

Fireworks AI https://api.fireworks.ai/inference/v1

(check their docs)

Ask the user to either pick a preset or provide custom values.

Required Fields

API Key (required): Their API key for the service

• Example: sk-... for OpenAI

Base URL (optional): API endpoint URL

• Default: https://api.openai.com

• Only needed if using a non-OpenAI service

Model Name (optional): Which model to use

• Default: gpt-image-1.5

• Different services use different model names

Optional: Test the connection

After collecting the info, suggest testing with curl:

curl -s <BASE_URL>/v1/models
-H "Authorization: Bearer <API_KEY>" | head -c 500

This helps catch invalid keys or wrong URLs before saving.

Proceed to Step 4 with config from the collected fields (see bottom of this section for format).

Only include fields that differ from defaults. Omit openaiBaseUrl if it's https://api.openai.com , omit openaiModel if it's gpt-image-1.5 .

Step 3D: Import from curl Example

Ask the user to paste their curl command. Common formats they might paste:

Format 1: Image generation endpoint

curl https://api.openai.com/v1/images/generations
-H "Authorization: Bearer sk-xxx"
-H "Content-Type: application/json"
-d '{"model": "gpt-image-1.5", "prompt": "a cat", "n": 1, "size": "1024x1024"}'

Format 2: Simple model list test

curl https://api.together.xyz/v1/models
-H "Authorization: Bearer xxx"

Format 3: With -u flag or other auth styles

curl -u :sk-xxx https://api.fireworks.ai/inference/v1/images/generations
-d '{"model": "accounts/fireworks/models/flux", "prompt": "a cat"}'

Parse the curl command and extract:

Base URL: The URL hostname + base path (strip /v1/images/generations , /v1/models , etc.)

• https://api.openai.com/v1/images/generations → https://api.openai.com

• https://api.together.xyz/v1/models → https://api.together.xyz/v1

• If URL ends with /v1/... , keep the /v1 part only if it's NOT api.openai.com

API Key: From Authorization: Bearer <key> header, or -u :<key> flag, or --header variants

Model: From the JSON request body "model": "<value>" if present

Show parsed results for confirmation:

I extracted the following from your curl command:

• API Key: sk-xxx... (first 10 chars)

• Base URL: https://api.together.xyz/v1

• Model: black-forest-labs/FLUX.1-schnell

Does this look correct?

If user confirms, proceed to Step 4. If not, let them correct individual fields.

Step 4: Save Configuration

Build the config JSON based on the chosen provider:

For MeiGen:

{ "meigenApiToken": "<the token>" }

For ComfyUI:

{ "comfyuiUrl": "<url, omit if default>", "comfyuiDefaultWorkflow": "<workflow name>" }

For OpenAI-compatible (manual or curl import):

{ "openaiApiKey": "<the key>", "openaiBaseUrl": "<base url, omit if default>", "openaiModel": "<model, omit if default>" }

Create the config directory and write the file:

mkdir -p ~/.config/meigen

Then use the Write tool to write the JSON config to ~/.config/meigen/config.json .

Important: If the user already has a config file with other providers configured, merge the new config into the existing one rather than overwriting. For example, a user might have both MeiGen and ComfyUI configured.

After writing, set permissions:

chmod 600 ~/.config/meigen/config.json

Step 5: Completion

Tell the user:

Configuration saved! To activate the new settings, please start a new Claude Code session (close and reopen, or open a new terminal tab).

After restarting, you can:

• Use generate_image to create AI images

• Run list_models to see available models and workflows

• Try: "Generate a beautiful sunset over mountains"

You can run /meigen:setup again anytime to change your configuration.

For ComfyUI users, additionally mention:

ComfyUI tips:

• Use comfyui_workflow list to see your saved workflows

• Use comfyui_workflow view to see adjustable parameters (steps, CFG, sampler, etc.)

• Ask me to change any workflow parameter — e.g., "increase steps to 30" or "switch sampler to dpmpp_2m"

• You can import more workflows anytime with comfyui_workflow import