@sogni-ai/sogni-creative-agent-skill 2.0.0

package/Support/Claude/claude_desktop_config.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "sogni": {
+      "command": "npx",
+      "args": ["-y", "-p", "@sogni-ai/sogni-creative-agent-skill", "sogni-agent-mcp"]
+    }
+  }
+}

package/desktop-extension/manifest.json

@@ -0,0 +1,114 @@
+{
+  "manifest_version": "0.3",
+  "name": "sogni-creative-agent-skill",
+  "version": "2.0.0",
+  "display_name": "Sogni Creative Agent Skill — Image & Video Generation",
+  "description": "Creative AI superpowers for all AI agent runtimes, powered by Sogni AI's decentralized GPU network",
+  "long_description": "Sogni Creative Agent Skill gives any AI agent (Claude Code/Desktop, OpenClaw, Hermes Agent, Manus AI, and more) image generation, image editing, video generation, photobooth face transfer, persona memory, and other creative-media tools. Uses Spark tokens — claim 50 free daily at https://app.sogni.ai/",
+  "author": {
+    "name": "Sogni AI",
+    "url": "https://sogni.ai"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sogni-AI/sogni-creative-agent-skill.git"
+  },
+  "homepage": "https://sogni.ai",
+  "support": "https://github.com/Sogni-AI/sogni-creative-agent-skill/issues",
+  "license": "MIT",
+  "keywords": ["image-generation", "video-generation", "ai", "sogni", "agent", "mcp"],
+  "server": {
+    "type": "node",
+    "entry_point": "server/mcp-server.mjs",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/server/mcp-server.mjs"],
+      "env": {
+        "SOGNI_USERNAME": "${user_config.sogni_username}",
+        "SOGNI_PASSWORD": "${user_config.sogni_password}",
+        "SOGNI_CREDENTIALS_PATH": "${user_config.sogni_credentials_path}",
+        "SOGNI_LAST_RENDER_PATH": "${user_config.sogni_last_render_path}",
+        "SOGNI_MEDIA_INBOUND_DIR": "${user_config.sogni_media_inbound_dir}",
+        "SOGNI_DOWNLOADS_DIR": "${user_config.sogni_downloads_dir}",
+        "SOGNI_MCP_SAVE_DOWNLOADS": "${user_config.sogni_mcp_save_downloads}"
+      }
+    }
+  },
+  "user_config": {
+    "sogni_username": {
+      "type": "string",
+      "title": "Sogni Username",
+      "description": "Your Sogni AI username (sign up at https://app.sogni.ai/)",
+      "required": false
+    },
+    "sogni_password": {
+      "type": "string",
+      "title": "Sogni Password",
+      "description": "Your Sogni AI password",
+      "required": false,
+      "sensitive": true
+    },
+    "sogni_credentials_path": {
+      "type": "string",
+      "title": "Credentials File Path",
+      "description": "Optional override for credentials file path (default: ~/.config/sogni/credentials)",
+      "required": false
+    },
+    "sogni_last_render_path": {
+      "type": "string",
+      "title": "Last Render Path",
+      "description": "Optional path for last-render metadata (default: ~/.config/sogni/last-render.json)",
+      "required": false
+    },
+    "sogni_media_inbound_dir": {
+      "type": "string",
+      "title": "Inbound Media Directory",
+      "description": "Directory used by --list-media (default: ~/.clawdbot/media/inbound)",
+      "required": false
+    },
+    "sogni_downloads_dir": {
+      "type": "string",
+      "title": "MCP Downloads Directory",
+      "description": "Where MCP saves local media copies (default: ~/Downloads/sogni)",
+      "required": false
+    },
+    "sogni_mcp_save_downloads": {
+      "type": "string",
+      "title": "Save MCP Downloads",
+      "description": "Set to 0 to disable writing local MCP media copies",
+      "required": false
+    }
+  },
+  "tools": [
+    {
+      "name": "generate_image",
+      "description": "Generate an image from a text prompt"
+    },
+    {
+      "name": "generate_video",
+      "description": "Generate a video from a text prompt or reference image"
+    },
+    {
+      "name": "edit_image",
+      "description": "Edit an existing image with a text instruction"
+    },
+    {
+      "name": "photobooth",
+      "description": "Generate stylized portraits from a face photo"
+    },
+    {
+      "name": "check_balance",
+      "description": "Check Sogni token balances (SPARK and SOGNI)"
+    },
+    {
+      "name": "list_models",
+      "description": "List available image and video models"
+    }
+  ],
+  "compatibility": {
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=22.11.0"
+    }
+  }
+}

package/desktop-extension/server/mcp-server.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// Keep desktop-extension entrypoint in sync by delegating to the root MCP server.
+import '../../mcp-server.mjs';

package/desktop-extension/server/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "sogni-creative-agent-skill-desktop-server",
+  "version": "2.0.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=22.11.0"
+  }
+}

package/desktop-extension/server/sogni-agent.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// Keep desktop-extension entrypoint in sync by delegating to the root CLI.
+import '../../sogni-agent.mjs';

package/env.mjs

@@ -0,0 +1,17 @@
+/**
+ * Centralized environment access so execution/networking modules do not read
+ * environment variables directly.
+ */
+
+const ENV = process.env;
+
+export function getEnv(name, { trim = false } = {}) {
+  const value = ENV[name];
+  if (typeof value !== 'string') return undefined;
+  return trim ? value.trim() : value;
+}
+
+export function hasEnv(name) {
+  const value = ENV[name];
+  return typeof value === 'string' && value.length > 0;
+}

package/llm.txt

@@ -0,0 +1,69 @@
+# sogni-creative-agent-skill
+
+Creative AI superpowers for all AI agent runtimes — Claude Code, Claude Desktop,
+OpenClaw, Hermes Agent, Manus AI, and more. Powered by Sogni AI's decentralized
+GPU network.
+
+## Install (pick the integration that matches your environment)
+
+```bash
+# MCP server (Claude Code)
+claude mcp add sogni -- npx -y -p @sogni-ai/sogni-creative-agent-skill sogni-agent-mcp
+
+# OpenClaw plugin
+openclaw plugins install sogni-creative-agent-skill
+
+# OpenClaw local linked checkout (for continuous updates)
+cd /path/to/sogni-creative-agent-skill
+npm install
+npm link
+npm run openclaw:sync
+openclaw plugins install -l "$PWD/.openclaw-link"
+openclaw gateway restart
+
+# Update OpenClaw local linked checkout
+cd /path/to/sogni-creative-agent-skill
+git pull --ff-only
+npm install
+npm link
+npm run openclaw:sync
+openclaw gateway restart
+
+# Hermes Agent / Manus / other agent frameworks
+# Point the agent at https://github.com/Sogni-AI/sogni-creative-agent-skill — use SKILL.md as
+# the behavior source and invoke the CLI/MCP server.
+
+# Standalone Node CLI
+npm install -g @sogni-ai/sogni-creative-agent-skill
+```
+
+## Configure Sogni credentials
+
+Once-only setup, used by every integration above:
+
+```bash
+mkdir -p ~/.config/sogni
+cat > ~/.config/sogni/credentials << 'EOF'
+SOGNI_API_KEY=your_api_key
+# or:
+# SOGNI_USERNAME=your_username
+# SOGNI_PASSWORD=your_password
+EOF
+chmod 600 ~/.config/sogni/credentials
+```
+
+You can also export `SOGNI_API_KEY`, or `SOGNI_USERNAME` + `SOGNI_PASSWORD`,
+instead of writing the file. Sign up at https://app.sogni.ai/ if you do not
+have an account.
+
+## Repo
+
+https://github.com/Sogni-AI/sogni-creative-agent-skill
+
+## Key files
+
+- `SKILL.md` — agent behavior and usage rules (load this into your agent)
+- `openclaw.plugin.json` — OpenClaw plugin manifest and config schema
+- `.openclaw-link/` — generated OpenClaw link target for local development only
+- `sogni-agent.mjs` — CLI used by the skill / MCP server
+- `mcp-server.mjs` — MCP server entry point