setup

Original🇺🇸 English
Translated

Configure MeiGen plugin provider and API keys. Use this when the user runs /meigen:setup, asks to "configure meigen", "set up image generation", "add API key", or needs help configuring the plugin.

9installs
Added on

NPX Install

npx skill4agent add jau123/meigen-art setup

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:
bash
cat ~/.config/meigen/config.json 2>/dev/null
Also check for existing ComfyUI workflows:
bash
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 Pro, GPT image 1.5, Seedream 4.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:
  1. Go to https://www.meigen.ai
  2. Sign in or create an account
  3. Navigate to Settings (click your avatar) → API Keys
  4. Click Create API Key, give it a name
  5. 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:
json
{
  "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:
bash
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:
    1. ComfyUI is running (start it with
      python main.py
      or your launcher)
    2. The URL and port are correct
    3. 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:
  1. Open ComfyUI in your browser (usually
    http://localhost:8188
    )
  2. Load or create your preferred workflow
  3. Click ⚙️ Settings → enable "Enable Dev mode options"
  4. Click the "Save (API Format)" button that appears
  5. 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:
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

ServiceBase URLDefault 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

  1. API Key (required): Their API key for the service
    • Example:
      sk-...
      for OpenAI
  2. Base URL (optional): API endpoint URL
    • Default:
      https://api.openai.com
    • Only needed if using a non-OpenAI service
  3. 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:
bash
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
bash
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
bash
curl https://api.together.xyz/v1/models \
  -H "Authorization: Bearer xxx"
Format 3: With -u flag or other auth styles
bash
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:

  1. 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
  2. API Key: From
    Authorization: Bearer <key>
    header, or
    -u :<key>
    flag, or
    --header
    variants
  3. 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:
json
{
  "meigenApiToken": "<the token>"
}
For ComfyUI:
json
{
  "comfyuiUrl": "<url, omit if default>",
  "comfyuiDefaultWorkflow": "<workflow name>"
}
For OpenAI-compatible (manual or curl import):
json
{
  "openaiApiKey": "<the key>",
  "openaiBaseUrl": "<base url, omit if default>",
  "openaiModel": "<model, omit if default>"
}
Create the config directory and write the file:
bash
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:
bash
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