sogni-creative-agent

Sogni Creative Agent Skill

Image, video, and music generation for AI agents — powered by Sogni AI's decentralized GPU network.

Sogni Creative Agent Skill plugs into the agent runtime you already use — Claude Code, OpenClaw, Hermes Agent, Manus AI, and others — and gives it production-quality image, video, and music generation through a single CLI: sogni-agent.

It ships three ways:

• a standalone Node.js CLI (sogni-agent)
• a skill source that any SKILL.md-aware agent can load
• a published OpenClaw plugin

With this skill, an agent can:

• generate images from prompts and edit/restyle existing images
• create videos from text, images, audio, or reference video (LTX-2.3, WAN 2.2, Seedance 2.0)
• generate instrumental music or full songs with lyrics
• run hosted creative workflows including storyboard-driven video
• save personas, preferences, and last-render state across sessions
• check balances, list models, and refine previous results

Fastest install: paste this repo's GitHub URL into your agent and ask it to "install this skill".

Table of Contents

• Quick Start
• Requirements
• Installation
  • Node CLI (default)
  • Claude Code plugin
  • OpenAI Codex CLI
  • Hermes Agent
  • OpenClaw plugin
  • ChatGPT (Custom GPT)
  • Manus / other SKILL.md frameworks
  • Manual install from source
  • Verify your install
  • Upgrading safely from inside an agent
• Setup (Sogni API key)
• Usage
• CLI Reference
  • Common options
  • Quality presets
  • Recommended models
• Video Sizing & Aspect Ratios
• LTX-2.3 Prompting Guide
• Photobooth (Face Transfer)
• Personas, Memory, and Personality
• Hosted API Modes
• Dynamic Prompt Variations
• Token Auto-Fallback
• Sogni Unlimited Subscription
• Error Reporting & Output
• For AI Agents
• Development
• License

Quick Start

1. Get a Sogni API key from dashboard.sogni.ai (open the account menu) and save it — see Setup.

2. Install (one command):

   npx setup-sogni-agent-skill
   

   This auto-detects Claude Code, OpenAI Codex CLI, and Hermes Agent; installs the CLI globally; registers the skill into each detected runtime; prompts for your API key; and prints ChatGPT Custom-GPT setup instructions. (It does not configure OpenClaw — see the OpenClaw plugin section.)

   Prefer to do it manually? Install the CLI directly:

   npm install -g @sogni-ai/sogni-creative-agent-skill@latest
   sogni-agent --version
   

   Then point your agent runtime at this repository's SKILL.md.

3. Verify the install:

   sogni-agent doctor
   

Then ask your agent to do something:

• "Generate an image of a sunset over mountains"
• "Edit this image to add a rainbow"
• "Make a video of a cat playing piano"
• "Generate a 30 second synthwave product-launch theme"
• "Turn my selfie into James Bond using photobooth"
• "Refine the last image at higher quality"

Requirements