dantelabs-agentic-school 1.0.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dantelabs-agentic-school",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "CLI tool for installing Dante Labs agentic plugins for Claude Code",
   "main": "cli/src/index.js",
   "type": "module",

package/plugins/brand-analytics/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "brand-analytics",
+  "description": "브랜드 소개서를 분석하여 포지셔닝, SWOT, 경쟁사 분석을 수행합니다.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Dante Labs",
+    "email": "datapod.k@gmail.com"
+  }
+}

package/plugins/campaign-orchestration/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "campaign-orchestration",
+  "description": "전체 마케팅 워크플로우를 통합하고 순차 실행합니다.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Dante Labs",
+    "email": "datapod.k@gmail.com"
+  }
+}

package/plugins/common/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "common",
+  "description": "공통 유틸리티 스킬 모음. 인증 관리, 문서 제작 도구(PPTX, PDF, DOCX), 이미지/비디오 생성(Kie.ai) 등 여러 플러그인에서 공통으로 사용하는 기능을 제공합니다.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Dante Labs",
+    "email": "datapod.k@gmail.com"
+  }
+}

package/plugins/common/skills/kie-image-generator/.env.example

@@ -0,0 +1,4 @@
+# Kie.ai API Configuration
+# Get your API key from: https://kie.ai/dashboard/api-keys
+
+KIEAI_API_KEY=your_api_key_here

package/plugins/common/skills/kie-image-generator/SKILL.md

@@ -0,0 +1,281 @@
+---
+name: kie-image-generator
+description: Generate images using Kie.ai's diverse AI models including GPT-4O Image, Flux Kontext, Nano Banana, Seedream, Imagen, and Ideogram. This skill should be used when the user requests AI-generated images, creative visuals, artwork creation, or image generation with specific styles. Supports 13+ models with full parameter control, automatic task polling, and usage tracking.
+---
+
+# Kie Image Generator
+
+## Overview
+
+Generate high-quality AI images using Kie.ai's comprehensive collection of image generation models. This skill provides access to 13+ state-of-the-art models including GPT-4O Image, Flux Kontext Pro/Max, Nano Banana, Nano Banana Pro (DeepSeed), Seedream 4.0, Imagen 4 variants, Ideogram V3, and Ideogram Character.
+
+**Key Features:**
+- 13+ AI image models with diverse capabilities
+- Credit/cost tracking and usage reporting
+- Interactive model selection with cost comparison
+- Automatic task polling and download
+
+## Quick Start
+
+**Check account credits:**
+```bash
+python scripts/generate_image.py --credits
+```
+
+**List available models with pricing:**
+```bash
+python scripts/generate_image.py --list-models
+```
+
+**Interactive mode (select model with cost display):**
+```bash
+python scripts/generate_image.py "a beautiful sunset over mountains"
+```
+
+**Direct model selection:**
+```bash
+python scripts/generate_image.py "cyberpunk city" --model flux-kontext-pro
+```
+
+**Skip confirmation:**
+```bash
+python scripts/generate_image.py "abstract art" --model seedream-v4 -y
+```
+
+## Supported Models
+
+### 1. GPT-4O Image (gpt4o-image)
+- **Best for:** Text rendering, complex scenes, photorealistic images
+- **Parameters:** `prompt`, `size` (1:1, 3:2, 2:3), `nVariants` (1-4)
+- **Speed:** Medium (~20-30s)
+
+### 2. Flux Kontext Pro (flux-kontext-pro)
+- **Best for:** Fast creative generation, artistic styles
+- **Parameters:** `prompt`, `image_ratio` (16:9, 21:9, 4:3, 1:1, 3:4, 9:16), `output_format` (jpeg, png)
+- **Speed:** Fast (8x faster than GPT-Image)
+
+### 3. Flux Kontext Max (flux-kontext-max)
+- **Best for:** High precision, typography, consistency
+- **Parameters:** Same as Flux Kontext Pro
+- **Speed:** Medium
+
+### 4. Nano Banana (nano-banana)
+- **Best for:** Hyper-realistic, physics-aware visuals
+- **Parameters:** `prompt`, `output_format` (PNG, JPEG), `image_size` (1:1, 9:16, 16:9, 3:4, 4:3, etc.)
+- **Speed:** Fast (~10-20s)
+
+### 5. Nano Banana Pro (nano-banana-pro) ✨ NEW
+- **Best for:** 3K/4K images, text rendering, character consistency
+- **Parameters:** `prompt`, `aspect_ratio` (1:1, 3:2, 16:9, etc.), `resolution` (sd, hd, 4k), `format` (jpg, png, webp), `image_input` (reference images)
+- **Speed:** Fast
+- **Pricing:** $0.04 (768px) / $0.11 (1024px)
+
+### 6. Seedream 4.0 (seedream-v4)
+- **Best for:** Fast generation, 2K-4K resolution
+- **Parameters:** `prompt`, `image_size`, `image_resolution` (1K, 2K, 4K), `max_images` (1-6), `seed`
+- **Speed:** Very fast (~1.8s for 2K)
+
+### 7. Imagen 4 Ultra (imagen-4-ultra)
+- **Best for:** Photorealistic, high-quality visuals
+- **Parameters:** `prompt`, `negative_prompt`, `aspect_ratio` (1:1, 16:9, 9:16, 3:4, 4:3), `num_images` (1-4), `seed`
+- **Speed:** Very fast (10x faster)
+
+### 8. Imagen 4 (imagen-4)
+- **Best for:** Balanced quality and speed
+- **Parameters:** Same as Imagen 4 Ultra
+- **Speed:** Fast
+
+### 9. Imagen 4 Fast (imagen-4-fast)
+- **Best for:** Quick iterations, drafts
+- **Parameters:** Same as Imagen 4 Ultra
+- **Speed:** Very fast
+
+### 10. Ideogram V3 (ideogram-v3)
+- **Best for:** Text rendering, typography
+- **Parameters:** `prompt`, `rendering_speed` (TURBO, BALANCED, QUALITY), `style` (AUTO, GENERAL, REALISTIC, DESIGN), `image_size`, `num_images` (1-4), `expand_prompt`, `seed`, `negative_prompt`
+- **Speed:** Variable (depends on rendering_speed)
+
+### 11. Ideogram Character (ideogram-character)
+- **Best for:** Character consistency, portraits
+- **Parameters:** `prompt`, `reference_image_urls`, `rendering_speed`, `style` (AUTO, REALISTIC, FICTION), `num_images` (1-4), `expand_prompt`, `seed`
+- **Speed:** Variable
+
+## Workflow
+
+### Step 1: Environment Setup
+
+Ensure `.env` file exists in the skill directory with Kie.ai API key:
+```bash
+KIEAI_API_KEY=your_api_key_here
+```
+
+If `.env` doesn't exist, the script will create it from `.env.example` and prompt for API key.
+
+### Step 2: Generate Image
+
+Run the generation script with desired parameters:
+
+```bash
+# Basic generation
+python scripts/generate_image.py "prompt"
+
+# With model selection
+python scripts/generate_image.py "prompt" --model MODEL_ID
+
+# With advanced parameters
+python scripts/generate_image.py "prompt" \
+  --model gpt4o-image \
+  --size "3:2" \
+  --variants 2 \
+  --output ~/Downloads/images/
+```
+
+### Step 3: Task Polling
+
+The script automatically:
+1. Submits generation task to Kie.ai
+2. Polls for completion (every 2 seconds)
+3. Downloads completed image
+4. Saves to output directory with timestamped filename
+
+## Advanced Usage
+
+### Model-Specific Parameters
+
+Each model has a dedicated module in `scripts/models/` with full parameter support:
+
+**GPT-4O Image:**
+```bash
+python scripts/generate_image.py "sunset" \
+  --model gpt4o-image \
+  --size "16:9" \
+  --variants 4
+```
+
+**Flux Kontext:**
+```bash
+python scripts/generate_image.py "abstract art" \
+  --model flux-kontext-pro \
+  --ratio "21:9" \
+  --format jpeg
+```
+
+**Nano Banana Pro:**
+```bash
+python scripts/generate_image.py "cinematic poster cool banana hero" \
+  --model nano-banana-pro \
+  --aspect-ratio "16:9" \
+  --resolution 4k \
+  --format png
+```
+
+**Seedream 4.0:**
+```bash
+python scripts/generate_image.py "landscape" \
+  --model seedream-v4 \
+  --resolution 4K \
+  --images 4 \
+  --seed 12345
+```
+
+**Imagen 4:**
+```bash
+python scripts/generate_image.py "portrait" \
+  --model imagen-4-ultra \
+  --aspect-ratio "3:4" \
+  --negative "blurry, low quality" \
+  --seed 67890
+```
+
+**Ideogram V3:**
+```bash
+python scripts/generate_image.py "logo design" \
+  --model ideogram-v3 \
+  --rendering QUALITY \
+  --style DESIGN \
+  --expand-prompt
+```
+
+### Batch Generation
+
+Generate multiple variations:
+```bash
+# 4 variants of same prompt
+python scripts/generate_image.py "cyberpunk city" --variants 4
+
+# Multiple prompts
+for prompt in "sunset" "moonrise" "starfield"; do
+  python scripts/generate_image.py "$prompt" --model imagen-4-fast
+done
+```
+
+## Resources
+
+### scripts/
+- `generate_image.py` - Main generation script with CLI interface
+- `models/` - Model-specific parameter handlers
+  - `gpt4o.py` - GPT-4O Image parameters
+  - `flux_kontext.py` - Flux Kontext Pro/Max parameters
+  - `nano_banana.py` - Nano Banana parameters
+  - `seedream.py` - Seedream 4.0 parameters
+  - `imagen.py` - Imagen 4 variants parameters
+  - `ideogram.py` - Ideogram V3/Character parameters
+- `utils.py` - Common utilities (polling, download, env loading)
+
+### references/
+- `api_docs.md` - Comprehensive Kie.ai API documentation
+
+## Error Handling
+
+The script handles common errors:
+- **Missing API key:** Prompts to create .env file
+- **Invalid model:** Lists available models
+- **Generation timeout:** Retries or reports timeout (max 2 minutes)
+- **API errors:** Displays error message and suggests solutions
+
+## Output Format
+
+Generated images are saved with descriptive filenames:
+```
+~/Downloads/images/gpt4o-image_sunset_20250113_203045.png
+~/Downloads/images/flux-kontext-pro_cyberpunk_20250113_203125.jpg
+```
+
+Format: `{model}_{prompt-slug}_{timestamp}.{ext}`
+
+## Credit System
+
+Kie.ai uses a credit-based pricing system:
+- **1 credit = $0.005 USD**
+- Credits are deducted upon task completion
+- Use `--credits` to check current balance
+
+### Estimated Credit Costs
+
+| Model | Est. Credits | Est. USD |
+|-------|-------------|----------|
+| Nano Banana | ~20 | $0.10 |
+| Imagen 4 Fast | ~25 | $0.12 |
+| Nano Banana Edit | ~25 | $0.12 |
+| Flux Kontext Pro | ~30 | $0.15 |
+| Seedream V4 | ~35 | $0.18 |
+| Nano Banana Pro | ~40 | $0.20 |
+| Ideogram V3 | ~40 | $0.20 |
+| Seedream V4 Edit | ~40 | $0.20 |
+| Ideogram Character | ~45 | $0.23 |
+| GPT-4O Image | ~50 | $0.25 |
+| Imagen 4 | ~50 | $0.25 |
+| Flux Kontext Max | ~60 | $0.30 |
+| Imagen 4 Ultra | ~100 | $0.50 |
+
+*Prices are estimates and may vary based on parameters.*
+
+## Usage Tracking
+
+After each generation, the script reports:
+```
+💰 Credits used: 45.0 ($0.23)
+   Remaining: 837.5 credits ($4.19)
+```
+
+This helps track spending and plan budget for generation tasks

package/plugins/common/skills/kie-image-generator/references/api_docs.md

@@ -0,0 +1,358 @@
+# Kie.ai API Documentation Reference
+
+Comprehensive reference for all Kie.ai image generation models.
+
+## Base URL
+```
+https://api.kie.ai
+```
+
+## Authentication
+All requests require `X-API-KEY` header:
+```
+X-API-KEY: your_api_key_here
+```
+
+## Workflow
+1. **Submit Task**: POST to generation endpoint → receive `taskId`
+2. **Poll Status**: GET record-info endpoint with `taskId` → wait for completion
+3. **Download**: Extract image URL from completed response
+
+## Response Format
+```json
+{
+  "code": 200,
+  "msg": "success",
+  "data": {
+    "taskId": "...",          // On task submission
+    "status": "completed",    // On polling
+    "imageUrl": "...",        // When completed
+    "progress": 0-100         // During processing
+  }
+}
+```
+
+---
+
+## GPT-4O Image
+
+**Generation**: `POST /api/v1/gpt4o-image/generate`
+**Record Info**: `GET /api/v1/gpt4o-image/record-info?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required)",
+  "size": "1:1 | 3:2 | 2:3 (default: 1:1)",
+  "variants": "1-4 (default: 1)"
+}
+```
+
+**Best For**: High-quality, creative images with OpenAI's DALL-E technology
+
+---
+
+## Flux Kontext Pro / Max
+
+**Generation**: `POST /api/v1/flux/kontext/generate`
+**Record Info**: `GET /api/v1/flux/kontext/record-info?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required)",
+  "ratio": "16:9 | 9:16 | 21:9 | 3:4 | 4:3 | 5:4 | 4:5 (default: 16:9)",
+  "output_format": "jpeg | png (default: png)",
+  "model": "flux-kontext-pro | flux-kontext-max"
+}
+```
+
+**Best For**:
+- **Pro**: Fast, professional results for general use
+- **Max**: Maximum quality for detailed scenes
+
+---
+
+## Nano Banana (Gemini 2.5 Flash) - v1 API
+
+**Generation**: `POST /api/v1/jobs/createTask` (model: `google/nano-banana`)
+**Record Info**: `GET /api/v1/jobs/recordInfo?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required)",
+  "output_format": "png | jpeg (default: png)",
+  "image_size": "1:1 | 9:16 | 16:9 | 3:4 | 4:3 | 3:2 | 2:3 | 5:4 | 4:5 | 21:9 | auto (default: 1:1)"
+}
+```
+
+**Best For**: Google Gemini-powered fast generation with various aspect ratios
+
+---
+
+## Nano Banana Pro (DeepSeed) - v2 API
+
+**Generation**: `POST /api/v2/jobs/createTask` (model: `nano-banana-pro`)
+**Record Info**: `GET /api/v1/jobs/recordInfo?taskId={taskId}`
+
+**Description**: DeepSeed's Nano Banana Pro delivers sharper 3K images, intelligent 4K scaling, improved text rendering, and enhanced character consistency.
+
+**Pricing**: $0.04 (768px) / $0.11 (1024px)
+
+**Request Body**:
+```json
+{
+  "model": "nano-banana-pro",
+  "callbackUrl": "string (optional)",
+  "input": {
+    "input_prompt": "string (required)",
+    "input_image_input": ["url1", "url2"] (optional, max 4 reference images),
+    "input_aspect_ratio": "1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 16:9 | 9:16 | 21:9 | 9:21 (default: 1:1)",
+    "input_resolution": "sd | hd | 4k (default: hd)",
+    "input_output_format": "jpg | png | webp (default: webp)"
+  }
+}
+```
+
+**Parameters**:
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| input_prompt | Yes | Image description |
+| input_image_input | No | Reference image URLs (up to 4 images, PNG/JPEG/GIF/WebP, max 10MB) |
+| input_aspect_ratio | No | Output aspect ratio |
+| input_resolution | No | Output resolution (sd/hd/4k) |
+| input_output_format | No | Output format (jpg/png/webp) |
+
+**Request Example**:
+```bash
+curl -X POST "https://api.kie.ai/api/v2/jobs/createTask" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -d '{
+    "model": "nano-banana-pro",
+    "input": {
+      "input_prompt": "cinematic poster cool banana hero in shades leaps from sci-fi pod",
+      "input_resolution": "hd",
+      "input_output_format": "png"
+    }
+  }'
+```
+
+**Response Example**:
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "task_id": "task_xxxxxxx"
+  }
+}
+```
+
+**Query Task Response**:
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "taskId": "task_12345678",
+    "model": "nano-banana-pro",
+    "state": "success",
+    "resultJson": "{\"resultUrls\":[\"https://example.com/generated-image.jpg\"]}",
+    "failCode": "",
+    "failMsg": "",
+    "costTime": 0,
+    "completeTime": 1698765432000,
+    "createTime": 1698765400000
+  }
+}
+```
+
+**State Values**:
+| State | Description |
+|-------|-------------|
+| waiting | Waiting for generation |
+| queuing | In queue |
+| generating | Generating |
+| success | Generation successful |
+| fail | Generation failed |
+
+**Best For**: High-quality 3K/4K images with improved text rendering and character consistency
+
+---
+
+## Seedream 4.0
+
+**Generation**: `POST /api/v1/bytedance/seedream-v4-text-to-image`
+**Record Info**: `GET /api/v1/bytedance/seedream-v4-text-to-image/record-info?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required, max 5000 chars)",
+  "image_size": "string (aspect ratio)",
+  "image_resolution": "1K | 2K | 4K (default: 2K)",
+  "max_images": "1-6 (default: 1)",
+  "seed": "integer (optional, for reproducibility)"
+}
+```
+
+**Best For**: High-resolution images with fine control, ByteDance technology
+
+---
+
+## Imagen 4 (Ultra / Standard / Fast)
+
+**Generation**:
+- `POST /api/v1/google/imagen-4-ultra`
+- `POST /api/v1/google/imagen-4`
+- `POST /api/v1/google/imagen-4-fast`
+
+**Record Info**:
+- `GET /api/v1/google/imagen-4-ultra/record-info?taskId={taskId}`
+- `GET /api/v1/google/imagen-4/record-info?taskId={taskId}`
+- `GET /api/v1/google/imagen-4-fast/record-info?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required)",
+  "negative_prompt": "string (optional)",
+  "aspect_ratio": "1:1 | 16:9 | 9:16 | 3:4 | 4:3 (default: 1:1)",
+  "num_images": "1-4 (default: 1)",
+  "seed": "integer (optional)"
+}
+```
+
+**Best For**:
+- **Ultra**: Maximum photorealism and detail
+- **Standard**: Balanced quality and speed
+- **Fast**: Quick iterations with good quality
+
+---
+
+## Ideogram V3
+
+**Generation**: `POST /api/v1/ideogram/v3-text-to-image`
+**Record Info**: `GET /api/v1/ideogram/v3-text-to-image/record-info?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required)",
+  "rendering_speed": "TURBO | BALANCED | QUALITY (default: BALANCED)",
+  "style": "AUTO | GENERAL | REALISTIC | DESIGN (default: AUTO)",
+  "image_size": "string (aspect ratio)",
+  "num_images": "1-4 (default: 1)",
+  "expand_prompt": "boolean (MagicPrompt enhancement)",
+  "seed": "integer (optional)",
+  "negative_prompt": "string (optional)"
+}
+```
+
+**Best For**: Text rendering in images, design work, versatile styles
+
+---
+
+## Ideogram Character
+
+**Generation**: `POST /api/v1/ideogram/character`
+**Record Info**: `GET /api/v1/ideogram/character/record-info?taskId={taskId}`
+
+**Parameters**:
+```json
+{
+  "prompt": "string (required)",
+  "rendering_speed": "TURBO | BALANCED | QUALITY (default: BALANCED)",
+  "style": "AUTO | REALISTIC | FICTION (default: AUTO)",
+  "image_size": "string (aspect ratio)",
+  "num_images": "1-4 (default: 1)",
+  "expand_prompt": "boolean (MagicPrompt enhancement)",
+  "seed": "integer (optional)",
+  "negative_prompt": "string (optional)",
+  "reference_image_urls": ["url1", "url2"] (optional, for character consistency)
+}
+```
+
+**Best For**: Consistent character generation across multiple images
+
+---
+
+## Error Handling
+
+**Common HTTP Status Codes**:
+- `200`: Success
+- `400`: Invalid parameters
+- `401`: Invalid API key
+- `404`: Endpoint not found
+- `429`: Rate limit exceeded
+- `500`: Server error
+
+**Task Status Values**:
+- `pending`: Task submitted, not yet processing
+- `processing`: Generation in progress
+- `completed`: Image ready
+- `failed`: Generation failed
+
+**Polling Best Practices**:
+- Poll every 2 seconds
+- Maximum 60 attempts (120 seconds total)
+- Check `status` field in response
+- Extract `imageUrl` when status is `completed`
+
+---
+
+## Rate Limits
+
+Rate limits vary by model and subscription tier. Monitor response headers and implement exponential backoff on 429 errors.
+
+---
+
+## Output Formats
+
+All models support PNG and JPEG output formats. Specify via `output_format` parameter where supported.
+
+**Default Formats**:
+- Most models: PNG
+- Flux Kontext: Configurable (PNG/JPEG)
+- Nano Banana: Configurable (PNG/JPEG)
+
+---
+
+## Examples
+
+### Basic Generation
+```bash
+curl -X POST https://api.kie.ai/api/v1/gpt4o-image/generate \
+  -H "X-API-KEY: your_key" \
+  -H "Content-Type: application/json" \
+  -d '{"prompt": "sunset over mountains"}'
+```
+
+### Poll Status
+```bash
+curl https://api.kie.ai/api/v1/gpt4o-image/record-info?taskId=abc123 \
+  -H "X-API-KEY: your_key"
+```
+
+### With Parameters
+```bash
+curl -X POST https://api.kie.ai/api/v1/ideogram/v3-text-to-image \
+  -H "X-API-KEY: your_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "prompt": "modern logo design",
+    "rendering_speed": "QUALITY",
+    "style": "DESIGN",
+    "num_images": 2
+  }'
+```
+
+---
+
+## Additional Resources
+
+- Official Documentation: https://docs.kie.ai
+- Model Comparisons: https://kie.ai/features
+- API Status: https://status.kie.ai