{"_id":"@eliasempresas/prometheus-avatar","_rev":"2-1d5e0a95429c5782e722fd2f781c3627","name":"@eliasempresas/prometheus-avatar","dist-tags":{"latest":"0.10.2-elias.2"},"versions":{"0.10.2-elias.1":{"name":"@eliasempresas/prometheus-avatar","version":"0.10.2-elias.1","keywords":["openclaw","openclaw-plugin","live2d","avatar","lip-sync","tts","emotion","ai-agent","image-generation","marketplace"],"author":{"url":"JC","name":"Myths Labs"},"license":"MIT","_id":"@eliasempresas/prometheus-avatar@0.10.2-elias.1","maintainers":[{"name":"eliasempresas","email":"eliasempresas0@gmail.com"}],"homepage":"https://prometheus.mythslabs.ai","bugs":{"url":"https://github.com/myths-labs/prometheus-avatar/issues"},"dist":{"shasum":"798e6a1e65082a87f74f2c8ac548a5ca150693ba","tarball":"https://registry.npmjs.org/@eliasempresas/prometheus-avatar/-/prometheus-avatar-0.10.2-elias.1.tgz","fileCount":7,"integrity":"sha512-UVzFxVGXrwKpf6jsItMI1sJOZFqrriScxc5uSE2L4HZFdfUCbHtJHDluLx0xC+OQmC0SlHvBLQ2ShHjYQ4fKbA==","signatures":[{"sig":"MEUCIDu6px7SnLdH/3ODpspDOrc8NS9UWuaV8iUIMaccOD2wAiEA8xT/6Ibz3LzGJAcUIhEOIp6DjZCJ3RU4i/Wts/NVj4c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38068},"main":"./dist/index.js","type":"module","gitHead":"5aa8f74ba0261cb2098571258ead3c15f6fd4be7","scripts":{"build":"tsup src/index.ts --format esm --clean"},"_npmUser":{"name":"eliasempresas","email":"eliasempresas0@gmail.com"},"openclaw":{"build":{"openclawVersion":"2026.7.2"},"compat":{"pluginApi":">=2026.3.23-1"},"extensions":["./dist/index.js"]},"repository":{"url":"git+https://github.com/myths-labs/prometheus-avatar.git","type":"git"},"_npmVersion":"10.9.2","description":"Prometheus Avatar OpenClaw plugin maintained by Elias Empresas","directories":{},"_nodeVersion":"22.13.0","dependencies":{"@prometheusavatar/core":"^0.11.3"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^7.0.2"},"_npmOperationalInternal":{"tmp":"tmp/prometheus-avatar_0.10.2-elias.1_1786660810934_0.28111255873457597","host":"s3://npm-registry-packages-npm-production"}},"0.10.2-elias.2":{"name":"@eliasempresas/prometheus-avatar","version":"0.10.2-elias.2","description":"Prometheus Avatar OpenClaw plugin maintained by Elias Empresas","type":"module","main":"./dist/index.js","license":"MIT","keywords":["openclaw","openclaw-plugin","live2d","avatar","lip-sync","tts","emotion","ai-agent","image-generation","marketplace"],"author":{"name":"Myths Labs","url":"JC"},"homepage":"https://prometheus.mythslabs.ai","dependencies":{"@prometheusavatar/core":"^0.11.3"},"openclaw":{"compat":{"pluginApi":">=2026.3.23-1"},"build":{"openclawVersion":"2026.7.2"},"extensions":["./dist/index.js"]},"scripts":{"build":"tsup src/index.ts --format esm --clean"},"devDependencies":{"tsup":"^8.0.0","typescript":"^7.0.2"},"repository":{"type":"git","url":"git+https://github.com/myths-labs/prometheus-avatar.git"},"_id":"@eliasempresas/prometheus-avatar@0.10.2-elias.2","gitHead":"5aa8f74ba0261cb2098571258ead3c15f6fd4be7","bugs":{"url":"https://github.com/myths-labs/prometheus-avatar/issues"},"_nodeVersion":"22.13.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-Br1wvWlZEixhZz7Xsgnel4p5FDLE0dr3OlbgRyKQNPRwYmkTRx+HsaMv1Lc3eC9yqPmLGWKB1ndqskLzcRliPg==","shasum":"33ae35394dffe17a273a4164419e14e7f2719a3d","tarball":"https://registry.npmjs.org/@eliasempresas/prometheus-avatar/-/prometheus-avatar-0.10.2-elias.2.tgz","fileCount":7,"unpackedSize":38243,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAWbnExMSpXTND/AqjUSnYDafox7oDbrBjR4drMAZudCAiEA9drCIwzRT+XWhXts1OQMiQWs1/82g710uOCM2SBtFRQ="}]},"_npmUser":{"name":"eliasempresas","email":"eliasempresas0@gmail.com"},"directories":{},"maintainers":[{"name":"eliasempresas","email":"eliasempresas0@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/prometheus-avatar_0.10.2-elias.2_1786661698166_0.5067668479141187"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-13T22:40:10.726Z","modified":"2026-08-13T22:54:58.469Z","0.10.2-elias.1":"2026-08-13T22:40:11.100Z","0.10.2-elias.2":"2026-08-13T22:54:58.309Z"},"bugs":{"url":"https://github.com/myths-labs/prometheus-avatar/issues"},"author":{"name":"Myths Labs","url":"JC"},"license":"MIT","homepage":"https://prometheus.mythslabs.ai","keywords":["openclaw","openclaw-plugin","live2d","avatar","lip-sync","tts","emotion","ai-agent","image-generation","marketplace"],"repository":{"type":"git","url":"git+https://github.com/myths-labs/prometheus-avatar.git"},"description":"Prometheus Avatar OpenClaw plugin maintained by Elias Empresas","maintainers":[{"name":"eliasempresas","email":"eliasempresas0@gmail.com"}],"readme":"# 🔥 Prometheus Avatar — OpenClaw Plugin\n\n> Give your OpenClaw agent a Live2D avatar with real-time lip-sync, emotion, TTS — **plus AAA image generation** for marketplace skin previews.\n\n[![npm](https://img.shields.io/badge/npm-%40prometheusavatar%2Fopenclaw--plugin-blue)](https://www.npmjs.com/package/@prometheusavatar/openclaw-plugin)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![OpenClaw](https://img.shields.io/badge/OpenClaw-merged-purple)](https://github.com/openclaw/openclaw/pull/52752)\n\n## 🚀 Install\n\n```bash\nopenclaw plugins install @prometheusavatar/openclaw-plugin\n```\n\n## ✨ What it does\n\nThis plugin bridges OpenClaw agent events to the [Prometheus Avatar SDK](https://www.npmjs.com/package/@prometheusavatar/core), giving your AI agent a visual body and the ability to create marketplace assets:\n\n- **🎭 Live2D Avatar** — Renders a Live2D model in your agent's UI\n- **🗣️ Text-to-Speech** — Agent messages spoken aloud with lip-sync\n- **😊 Emotion Detection** — Text sentiment drives expressions (happy / sad / angry / surprised / thinking)\n- **🎨 AAA Image Generation (v0.9+)** — Generate game-store-tier skin preview cards directly from your agent conversation\n- **🛒 Marketplace Asset Pipeline** — Generate thumbnails + deploy assets without leaving the agent loop\n- **🎓 Bundled Skill (NEW v0.10)** — Plugin now ships with an AgentSkills-compatible `SKILL.md` at `skills/prometheus-avatar/` that teaches the agent when and how to use the 3 creator tools. Auto-loaded when the plugin is enabled. See [OpenClaw Skills docs](https://github.com/openclaw/openclaw/blob/main/docs/tools/skills.md).\n\n## ⚙️ Configuration\n\nAdd to your `openclaw.config.json`:\n\n```json\n{\n  \"plugins\": {\n    \"prometheus-avatar\": {\n      \"modelUrl\": \"https://your-cdn.example/models/your-model.model3.json\",\n      \"apiKey\": \"pak_...\",\n      \"enableLipSync\": true,\n      \"enableEmotion\": true\n    }\n  }\n}\n```\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `avatarId` | `string` | — | Reserved — ID-based model resolution is not available yet; use `modelUrl` (when only `avatarId` is set the default model is used) |\n| `apiKey` | `string` | `PROMETHEUS_API_KEY` env var | Prometheus agent API key (`pak_...`) — required for marketplace deploys (the live gate rejects unauthenticated writes). Get one at [prometheus.mythslabs.ai/settings/agent-keys](https://prometheus.mythslabs.ai/settings/agent-keys) |\n| `modelUrl` | `string` | Haru (default) | Direct URL to a `.model3.json` file |\n| `ttsProvider` | `string` | — | **DEPRECATED in v0.10.0** — ignored. TTS is now delegated to the Prometheus SDK. |\n| `ttsVoice` | `string` | — | Prometheus Marketplace voice ID (e.g. `saturn_zh_female_keainvsheng_tob`). Browse voices at [prometheus.mythslabs.ai/marketplace](https://prometheus.mythslabs.ai/marketplace) |\n| `enableLipSync` | `boolean` | `true` | Audio-driven lip synchronization |\n| `enableEmotion` | `boolean` | `true` | Emotion analysis from text |\n\n## 🎓 Bundled Skill (NEW v0.10)\n\nThe plugin ships with a bundled OpenClaw Skill at `skills/prometheus-avatar/SKILL.md` so the agent knows **when** and **how** to use the 3 creator tools below without explicit user prompting. The Skill covers:\n\n- **When to use** — visible character / avatar mascot · real-time TTS with mouth movement · emotion reflection · AAA skin preview card · marketplace asset deploy\n- **When NOT to use** — plain audio TTS · low-fidelity thumbnails · deterministic image requirements\n- **Tool selection rules** — `prometheus_generate_image_pro` (AAA-tier · primary) vs `prometheus_generate_thumbnail` (legacy lighter) vs `prometheus_deploy_asset`\n- **Prompt-is-the-ceiling** — recommend ≥100-word prompts with explicit AAA benchmark (Genshin / Overwatch / WoW / Pixar / Studio Ghibli)\n- **Safety** — cost awareness · marketplace deploy confirmation · prompt sanitisation\n\nThe Skill auto-loads when the plugin is enabled — no separate install step.\n\n## 🛠️ Agent Tools (3)\n\nWhen your OpenClaw agent has tool-use enabled, the plugin registers 3 creator tools:\n\n| Tool | Description |\n|------|-------------|\n| `prometheus_generate_image_pro` | **NEW v0.9** Generate AAA-quality images (skin preview cards, posters, UI mocks). Genshin / Overwatch / WoW shop card tier. 9 style presets · BYOK · Free quota · Pro Credits. |\n| `prometheus_generate_thumbnail` | Generate marketplace asset thumbnails (legacy route — kept for backward compat) |\n| `prometheus_deploy_asset` | Deploy new assets (voices, skins, effects) to the Marketplace |\n\n### Example: Generate a skin preview card\n\n```\nUser: \"Generate a cyberpunk anime girl skin in AAA Genshin Impact shop card tier\"\n\nAgent (via prometheus_generate_image_pro):\n  {\n    style: \"cyberpunk\",\n    taskType: \"aaa_skin\",\n    size: \"1024x1536\",\n    quality: \"high\",\n    prompt: \"3D cel-shaded engine render, anime girl with neon hair and tech visor, slight elevated 3/4 hero pose, glossy game-art materials, clean dark studio backdrop with subtle radial gradient, cyan / magenta rim lighting, NOT flat 2D illustration, Genshin Impact / Overwatch shop preview tier, production-ready AAA skin preview card.\"\n  }\n```\n\nReturns 1024×1536 base64 image (or `publicUrl` when `upload: true`) — ready to ship to the marketplace.\n\n> **💡 Twin Prompt-Is-The-Ceiling rule**: Recommend ≥100-word prompts with explicit AAA benchmark named (Genshin / Overwatch / WoW / Pixar / Studio Ghibli). Lazy short prompts produce mediocre output — the model can render anything if you describe it precisely.\n\n## 📡 Events\n\n| Listens to | Emits |\n|------------|-------|\n| `agent:message` → speaks + animates | `avatar:speak` |\n| `agent:thinking` → thinking expression | `avatar:emotion` |\n| `agent:error` → surprised expression | `avatar:ready` |\n\n## 🌍 Ecosystem\n\n- **OpenClaw** — Merged into the official [community plugin registry](https://github.com/openclaw/openclaw/pull/52752) (4/21/2026, by Peter Steinberger)\n- **Hermes Agent** — Avatar skill PR submitted at [`NousResearch/hermes-agent#9754`](https://github.com/NousResearch/hermes-agent/pull/9754)\n- **Cursor / Claude Code / Any MCP Client** — Use the [`@prometheusavatar/mcp-server`](https://www.npmjs.com/package/@prometheusavatar/mcp-server) (10 tools) for direct MCP access to the same image engine\n\n## 🔗 Links\n\n- **SDK**: [@prometheusavatar/core](https://www.npmjs.com/package/@prometheusavatar/core) v0.11+\n- **MCP server**: [@prometheusavatar/mcp-server](https://www.npmjs.com/package/@prometheusavatar/mcp-server) v0.3+\n- **Marketplace**: [prometheus.mythslabs.ai](https://prometheus.mythslabs.ai)\n- **Forge UI** (visual reference): [marketplace/create](https://prometheus.mythslabs.ai/marketplace/create) — 7-style picker\n- **GitHub**: [myths-labs/prometheus-avatar](https://github.com/myths-labs/prometheus-avatar)\n\n## 📄 License\n\nMIT © [Myths Labs](https://mythslabs.ai)\n","readmeFilename":"README.md"}