setup
One-time setup for image and video generation APIs — Vertex AI, WaveSpeed, and Higgsfield credentials stored persistently and verified before use. Triggers on \"/setup\", \"set up socialforge\", \"configure the APIs\", \"add credentials\", \"connect vertex\", \"credential status\", or before any creative production on a new machine. Keys live outside the repo; nothing is committed to git.
indranilbanerjee · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add indranilbanerjee/socialforge --skill setup技能说明
name: setup description: "One-time setup for image and video generation APIs — Vertex AI, WaveSpeed, and Higgsfield credentials stored persistently and verified before use. Triggers on "/setup", "set up socialforge", "configure the APIs", "add credentials", "connect vertex", "credential status", or before any creative production on a new machine. Keys live outside the repo; nothing is committed to git." argument-hint: "[--image | --video | --fallback | --status | --reset]" effort: low user-invocable: true
/socialforge:setup — API Credential Configuration
One-time setup that stores credentials persistently. Run once, works forever across all sessions.
Context efficiency
Asset-heavy skill. Grep before Read the asset catalog (${CLAUDE_PLUGIN_DATA}/socialforge/brands/<brand>/asset-index.json) — never list the asset directory. Reference generated images / videos by path, not by loading metadata. Brand profile loads once per session.
What This Does
Configures two services that SocialForge needs for creative production:
- Google Cloud Vertex AI (required for images) — Nano Banana 2 (Gemini 3.1 Flash Image) + Nano Banana Pro (Gemini 3 Pro Image)
- WaveSpeed (required for video) — Kling v3.0 Pro for image-to-video
Prerequisites
Your admin provides you with:
- A Google Cloud service account JSON file (for image generation)
- A WaveSpeed API key (for video generation)
If you are the admin, see the Admin Setup section below.
How to Run
/socialforge:setup
Interactive Flow
Step 0: Install Dependencies (Automatic)
Run this first — installs all required Python packages:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/install_deps.py"
This auto-installs: google-genai (Vertex AI), wavespeed (Kling video), Pillow (compositing), imageio-ffmpeg (video post-processing), playwright (carousels).
If any package fails, show the manual install command and continue.
Step 1: Image Generation (Vertex AI)
Check if already configured:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/credential_manager.py" status
If not configured, ask:
Image Generation Setup (Google Cloud Vertex AI)
Do you have a Google Cloud service account JSON file?
Provide the full file path (e.g., C:\Users\you\Downloads\socialforge-credentials.json)
Or type "skip" to configure later (image generation will not work).
When user provides the path:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/credential_manager.py" setup-vertex --json-path "<user-provided-path>"
Show the result. If success:
Image generation configured.
Project: <project_id>
Service Account: <email>
Models available: gemini-3.1-flash-image (Nano Banana 2), gemini-3-pro-image (Nano Banana Pro)
Step 2: Video Generation (WaveSpeed)
Video Generation Setup (WaveSpeed / Kling v3.0)
Do you have a WaveSpeed API key?
Paste the key here
Or type "skip" to configure later (video generation will not work).
When user provides the key:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/credential_manager.py" setup-wavespeed --api-key "<user-provided-key>"
Show the result. If success:
Video generation configured.
Provider: WaveSpeed (Kling v3.0 Pro)
Models: image-to-video, text-to-video (3-15 seconds)
Step 2.5: HiggsField (Optional Fallback)
HiggsField Setup (Optional — adds fallback resilience)
Do you have a HiggsField API key and secret?
→ Paste the API key, then the API secret
Or type "skip" (HiggsField is optional — Vertex AI and WaveSpeed are sufficient).
When user provides both:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/credential_manager.py" setup-higgsfield --api-key "<key>" --api-secret "<secret>"
Step 3: Summary
SocialForge API Setup Complete
Image Generation: [configured / not configured]
Provider: Google Cloud Vertex AI
Project: <project_id>
Models: Nano Banana 2 (Gemini 3.1 Flash Image), Nano Banana Pro (Gemini 3 Pro Image)
Video Generation: [configured / not configured]
Provider: WaveSpeed (Kling v3.0 Pro)
Modes: image-to-video, text-to-video
HiggsField: [configured / skipped]
Provider: HiggsField (Soul v2 + Kling v2.1, fallback)
Credentials stored persistently. No further setup needed.
Next: /socialforge:brand-setup [brand-name] to configure your first brand.
Arguments
| Argument | Effect |
|---|---|
| (none) | Run full interactive setup |
--image | Configure image generation only (Vertex AI) |
--video | Configure video generation only (WaveSpeed) |
--fallback | Configure HiggsField fallback only |
--status | Show current configuration status |
--reset | Remove all stored credentials and start fresh |
Admin Setup Guide
If you are setting up the cloud accounts for your team, follow these detailed guides.
Google Cloud (Vertex AI — Image Generation)
Step 1: Create a Google Cloud Project
- Open https://console.cloud.google.com/
- If you don't have an account, click "Get started for free" and follow registration
- Click the project dropdown at the top of the page (next to "Google Cloud")
- Click "NEW PROJECT"
- Enter a project name (e.g., "socialforge-production")
- Click "CREATE"
- Wait for the project to be created (30 seconds), then select it from the dropdown
Step 2: Enable Billing
- Go to https://console.cloud.google.com/billing
- Click "LINK A BILLING ACCOUNT"
- If you don't have a billing account, click "CREATE BILLING ACCOUNT"
- Add a payment method (credit card)
- New accounts may come with promotional credits — the console states the current offer and its expiry. This skill does not quote it, because a number stated from memory is wrong the moment the vendor changes it.
Step 3: Enable Vertex AI API
- Go to https://console.cloud.google.com/apis/library
- Search for "Vertex AI API"
- Click on it, then click "ENABLE"
- Wait for it to activate (takes a few seco