{
  "schemaVersion": "1.0",
  "item": {
    "slug": "sideload-avatar-generator",
    "name": "Sideload Avatar Generator",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/DirectiveCreator/sideload-avatar-generator",
    "canonicalUrl": "https://clawhub.ai/DirectiveCreator/sideload-avatar-generator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/sideload-avatar-generator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sideload-avatar-generator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SIDELOAD-API.md",
      "SKILL.md",
      "package.json",
      "scripts/generate.js",
      "scripts/status.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/sideload-avatar-generator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/sideload-avatar-generator",
    "agentPageUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Sideload Avatar Generator",
        "body": "Generate 3D avatars from text prompts or reference images using Sideload.gg. Pay-per-use via the x402 protocol — $2 USDC per generation on Base.\n\nWorks with any x402 wallet. Bring your own wallet and private key — no proprietary wallet required."
      },
      {
        "title": "What You Get",
        "body": "Each generation produces four formats:\n\nFormatFileUse CaseGLB.glbUniversal 3D — Three.js, Unity, Unreal, web viewersVRM.vrmAvatar standard — VRChat, VTubing, social appsMMLURLMetaverse Markup Language — for MML-compatible worldsPNG.pngProcessed reference image used for generation"
      },
      {
        "title": "🎭 Rendering Avatars with @pixiv/three-vrm",
        "body": "The VRM output is designed to work with @pixiv/three-vrm — the standard Three.js library for loading, displaying, and animating VRM avatars. If you're already building with Three.js, generated avatars plug right in with full skeleton support:\n\nimport * as THREE from 'three';\nimport { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';\nimport { VRMLoaderPlugin } from '@pixiv/three-vrm';\n\nconst loader = new GLTFLoader();\nloader.register((parser) => new VRMLoaderPlugin(parser));\n\nloader.load('https://aiml.sideload.gg/models/avt-xxx.vrm', (gltf) => {\n  const vrm = gltf.userData.vrm;\n  scene.add(vrm.scene);\n\n  // Animate bone transforms, look-at, etc.\n});\n\nThis makes it easy to generate an avatar with Sideload and immediately use it in any Three.js scene — games, social apps, virtual worlds, VTubing, and more.\n\nFor more on building interactive 3D experiences in the metaverse, see awesome-mml — a curated list of MML (Metaverse Markup Language) resources."
      },
      {
        "title": "Prerequisites",
        "body": "Node.js 18+\n\n\nAn x402 payment token — sign a payment with your own wallet/signer and pass it via --x402-token. This skill never handles private keys.\n# Check the cost first\nnode scripts/generate.js --probe\n\n# Generate with your x402 token\nnode scripts/generate.js --prompt \"...\" --x402-token <base64-encoded-payment>\n\nUse any x402-compatible client to obtain a payment token: Coinbase x402 SDK, Thirdweb x402, or your own signing flow."
      },
      {
        "title": "Setup",
        "body": "npm install"
      },
      {
        "title": "Generate from Text Prompt",
        "body": "node scripts/generate.js --prompt \"A cyberpunk samurai with glowing red armor\" --x402-token <token>"
      },
      {
        "title": "Generate from Image URL",
        "body": "node scripts/generate.js --image https://example.com/character.png --x402-token <token>"
      },
      {
        "title": "Generate from Local Image",
        "body": "node scripts/generate.js --image /path/to/photo.jpg --x402-token <token>"
      },
      {
        "title": "Check Cost (No Payment)",
        "body": "node scripts/generate.js --probe"
      },
      {
        "title": "Check Job Status",
        "body": "node scripts/status.js avt-a1b2c3d4"
      },
      {
        "title": "Options",
        "body": "FlagDescription--prompt \"text\"Text description of the avatar--image <url-or-path>Reference image (URL or local file path)--x402-token <token>x402 payment token (required for generation)--probeCheck cost without generating--output <name>Custom filename for downloaded files--no-downloadSkip downloading result files"
      },
      {
        "title": "API Reference",
        "body": "See SIDELOAD-API.md for the full API documentation, or visit sideload.gg/agents/raw."
      },
      {
        "title": "Quick Reference",
        "body": "Generate:\n\nPOST https://sideload.gg/api/agent/generate\nHeaders: Content-Type: application/json, x-payment: <x402_token>\n\nText: { \"type\": \"text\", \"prompt\": \"description\" }\nImage: { \"type\": \"image\", \"imageUrl\": \"https://...\" }\n\nPoll: GET https://sideload.gg/api/agent/generate/{jobId}/status (no auth needed)"
      },
      {
        "title": "Prompt Tips",
        "body": "Be specific about:\n\nAppearance: clothing, colors, accessories\nStyle: realistic, anime, cartoon, cyberpunk\nFeatures: armor, weapons, hairstyle, wings\n\nGood prompts:\n\n\"A steampunk engineer with leather tool belt, copper mechanical arm, weathered pilot hat\"\n\"An anime-style sorceress with long silver hair, glowing purple eyes, ornate golden staff\"\n\"A futuristic soldier in white and blue power armor with glowing energy shield\""
      },
      {
        "title": "Image Tips",
        "body": "PNG, JPG, or WebP\nFront-facing portraits or full-body shots work best\nClear outlines and distinct clothing/features\nHigher resolution → better results"
      },
      {
        "title": "Rate Limits & Cost",
        "body": "$2 USDC per generation (x402 on Base, chain ID 8453)\n10 generations per 30 minutes per wallet\nCheck Retry-After header on 429 responses"
      },
      {
        "title": "Links",
        "body": "Sideload.gg\nAPI Documentation\n@pixiv/three-vrm — Three.js VRM avatar loader\nawesome-mml — MML resources for the metaverse\nx402 Protocol\nCoinbase x402 SDK\nVRM Specification\nMML (Metaverse Markup Language)"
      }
    ],
    "body": "Sideload Avatar Generator\n\nGenerate 3D avatars from text prompts or reference images using Sideload.gg. Pay-per-use via the x402 protocol — $2 USDC per generation on Base.\n\nWorks with any x402 wallet. Bring your own wallet and private key — no proprietary wallet required.\n\nWhat You Get\n\nEach generation produces four formats:\n\nFormat\tFile\tUse Case\nGLB\t.glb\tUniversal 3D — Three.js, Unity, Unreal, web viewers\nVRM\t.vrm\tAvatar standard — VRChat, VTubing, social apps\nMML\tURL\tMetaverse Markup Language — for MML-compatible worlds\nPNG\t.png\tProcessed reference image used for generation\n🎭 Rendering Avatars with @pixiv/three-vrm\n\nThe VRM output is designed to work with @pixiv/three-vrm — the standard Three.js library for loading, displaying, and animating VRM avatars. If you're already building with Three.js, generated avatars plug right in with full skeleton support:\n\nimport * as THREE from 'three';\nimport { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';\nimport { VRMLoaderPlugin } from '@pixiv/three-vrm';\n\nconst loader = new GLTFLoader();\nloader.register((parser) => new VRMLoaderPlugin(parser));\n\nloader.load('https://aiml.sideload.gg/models/avt-xxx.vrm', (gltf) => {\n  const vrm = gltf.userData.vrm;\n  scene.add(vrm.scene);\n\n  // Animate bone transforms, look-at, etc.\n});\n\n\nThis makes it easy to generate an avatar with Sideload and immediately use it in any Three.js scene — games, social apps, virtual worlds, VTubing, and more.\n\nFor more on building interactive 3D experiences in the metaverse, see awesome-mml — a curated list of MML (Metaverse Markup Language) resources.\n\nPrerequisites\n\nNode.js 18+\n\nAn x402 payment token — sign a payment with your own wallet/signer and pass it via --x402-token. This skill never handles private keys.\n\n# Check the cost first\nnode scripts/generate.js --probe\n\n# Generate with your x402 token\nnode scripts/generate.js --prompt \"...\" --x402-token <base64-encoded-payment>\n\n\nUse any x402-compatible client to obtain a payment token: Coinbase x402 SDK, Thirdweb x402, or your own signing flow.\n\nSetup\nnpm install\n\nUsage\nGenerate from Text Prompt\nnode scripts/generate.js --prompt \"A cyberpunk samurai with glowing red armor\" --x402-token <token>\n\nGenerate from Image URL\nnode scripts/generate.js --image https://example.com/character.png --x402-token <token>\n\nGenerate from Local Image\nnode scripts/generate.js --image /path/to/photo.jpg --x402-token <token>\n\nCheck Cost (No Payment)\nnode scripts/generate.js --probe\n\nCheck Job Status\nnode scripts/status.js avt-a1b2c3d4\n\nOptions\nFlag\tDescription\n--prompt \"text\"\tText description of the avatar\n--image <url-or-path>\tReference image (URL or local file path)\n--x402-token <token>\tx402 payment token (required for generation)\n--probe\tCheck cost without generating\n--output <name>\tCustom filename for downloaded files\n--no-download\tSkip downloading result files\nAPI Reference\n\nSee SIDELOAD-API.md for the full API documentation, or visit sideload.gg/agents/raw.\n\nQuick Reference\n\nGenerate:\n\nPOST https://sideload.gg/api/agent/generate\nHeaders: Content-Type: application/json, x-payment: <x402_token>\n\n\nText: { \"type\": \"text\", \"prompt\": \"description\" } Image: { \"type\": \"image\", \"imageUrl\": \"https://...\" }\n\nPoll: GET https://sideload.gg/api/agent/generate/{jobId}/status (no auth needed)\n\nPrompt Tips\n\nBe specific about:\n\nAppearance: clothing, colors, accessories\nStyle: realistic, anime, cartoon, cyberpunk\nFeatures: armor, weapons, hairstyle, wings\n\nGood prompts:\n\n\"A steampunk engineer with leather tool belt, copper mechanical arm, weathered pilot hat\"\n\"An anime-style sorceress with long silver hair, glowing purple eyes, ornate golden staff\"\n\"A futuristic soldier in white and blue power armor with glowing energy shield\"\nImage Tips\nPNG, JPG, or WebP\nFront-facing portraits or full-body shots work best\nClear outlines and distinct clothing/features\nHigher resolution → better results\nRate Limits & Cost\n$2 USDC per generation (x402 on Base, chain ID 8453)\n10 generations per 30 minutes per wallet\nCheck Retry-After header on 429 responses\nLinks\nSideload.gg\nAPI Documentation\n@pixiv/three-vrm — Three.js VRM avatar loader\nawesome-mml — MML resources for the metaverse\nx402 Protocol\nCoinbase x402 SDK\nVRM Specification\nMML (Metaverse Markup Language)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/DirectiveCreator/sideload-avatar-generator",
    "publisherUrl": "https://clawhub.ai/DirectiveCreator/sideload-avatar-generator",
    "owner": "DirectiveCreator",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/sideload-avatar-generator",
    "downloadUrl": "https://openagent3.xyz/downloads/sideload-avatar-generator",
    "agentUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sideload-avatar-generator/agent.md"
  }
}