{"_id":"@dhee_ai/runner-boogu","_rev":"2-26343f7cc553c09a617f3a31dfa7186a","name":"@dhee_ai/runner-boogu","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@dhee_ai/runner-boogu","version":"0.1.0","keywords":["dhee-runner"],"license":"Apache-2.0","_id":"@dhee_ai/runner-boogu@0.1.0","maintainers":[{"name":"dheeai_indhic","email":"indhicdev@gmail.com"},{"name":"kiran7893","email":"myadaramsaikiran@gmail.com"},{"name":"ganaraj","email":"ganarajpr@gmail.com"}],"homepage":"https://github.com/dheeai/dhee-runner-boogu#readme","bugs":{"url":"https://github.com/dheeai/dhee-runner-boogu/issues"},"dhee":{"runners":"./dist/index.js"},"dist":{"shasum":"5c001350528f0294c65efbde5ca9a724f26dd484","tarball":"https://registry.npmjs.org/@dhee_ai/runner-boogu/-/runner-boogu-0.1.0.tgz","fileCount":13,"integrity":"sha512-TXH8JjyljRwsAdBXmIvtcirqeU8S+1jLZ0ZoKVMLZsMhJyf+TuExfs3woKJeYU7Zn0kS/bOxA1RojLdhGO/Gpw==","signatures":[{"sig":"MEYCIQD2lkj/5z2ZJQANud+B2vzbetQQqitNuWIOVck72tr/owIhAOthIuu7eDBtYwWop3LpNI9g+ZOKTHNLcz97E+r+ZNYf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48716},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"67032a4c64c70dc60d9d6a4d897ef0172470f43e","scripts":{"build":"tsc -p tsconfig.json","prepare":"npm run build","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"dheeai_indhic","email":"indhicdev@gmail.com"},"repository":{"url":"git+https://github.com/dheeai/dhee-runner-boogu.git","type":"git"},"_npmVersion":"11.6.2","description":"Boogu image-edit runner for Dhee (comfy.boogu): prompt + up to 4 reference images into a ComfyUI Boogu edit workflow on a local GPU.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@dheeai/runner-sdk":"^0.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.29"},"_npmOperationalInternal":{"tmp":"tmp/runner-boogu_0.1.0_1782383233690_0.5716132530309872","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@dhee_ai/runner-boogu","version":"0.1.1","description":"Boogu image-edit runner for Dhee (comfy.boogu): prompt + up to 4 reference images into a ComfyUI Boogu edit workflow on a local GPU.","type":"module","license":"Apache-2.0","keywords":["dhee-runner"],"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"dhee":{"runners":"./dist/index.js"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","prepare":"npm run build"},"engines":{"node":">=20.0.0"},"dependencies":{"@dhee_ai/runner-sdk":"^0.1.3"},"devDependencies":{"@types/node":"^22.15.29","typescript":"^5.8.3"},"repository":{"type":"git","url":"git+https://github.com/dheeai/dhee-runner-boogu.git"},"homepage":"https://github.com/dheeai/dhee-runner-boogu#readme","publishConfig":{"access":"public"},"gitHead":"66a88051a1b834f4c4ce1a7ec041d0c342bf4a4e","_id":"@dhee_ai/runner-boogu@0.1.1","bugs":{"url":"https://github.com/dheeai/dhee-runner-boogu/issues"},"_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-65UzFQPM1DGXjtybFdwGEmMYcT2cLQqeSHpPdxrafTaE+S2Yl1CuK9rfc09kn7z1K8V1GPt9H6djlmh5g7usRg==","shasum":"930f2e86efa6dd88c953a8352eaf3d51f9174df8","tarball":"https://registry.npmjs.org/@dhee_ai/runner-boogu/-/runner-boogu-0.1.1.tgz","fileCount":13,"unpackedSize":48765,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGbGk5qwkL/loau5TKEYhM/oaLdd9kq36qoN3+1VGpTmAiEApsa3SFi/BWyCLHCw9AWCFIiZcbkEx0sb5/Yn37y1Gs0="}]},"_npmUser":{"name":"dheeai_indhic","email":"indhicdev@gmail.com"},"directories":{},"maintainers":[{"name":"dheeai_indhic","email":"indhicdev@gmail.com"},{"name":"kiran7893","email":"myadaramsaikiran@gmail.com"},{"name":"ganaraj","email":"ganarajpr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/runner-boogu_0.1.1_1782398609689_0.5779171826054292"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-25T10:27:13.529Z","modified":"2026-06-25T14:43:29.972Z","0.1.0":"2026-06-25T10:27:13.822Z","0.1.1":"2026-06-25T14:43:29.833Z"},"bugs":{"url":"https://github.com/dheeai/dhee-runner-boogu/issues"},"license":"Apache-2.0","homepage":"https://github.com/dheeai/dhee-runner-boogu#readme","keywords":["dhee-runner"],"repository":{"type":"git","url":"git+https://github.com/dheeai/dhee-runner-boogu.git"},"description":"Boogu image-edit runner for Dhee (comfy.boogu): prompt + up to 4 reference images into a ComfyUI Boogu edit workflow on a local GPU.","maintainers":[{"name":"dheeai_indhic","email":"indhicdev@gmail.com"},{"name":"kiran7893","email":"myadaramsaikiran@gmail.com"},{"name":"ganaraj","email":"ganarajpr@gmail.com"}],"readme":"# dhee-runner-boogu\n\nBoogu image-edit runner for [Dhee](https://github.com/dheeai/dhee-core) —\nexposes the **`comfy.boogu`** tool. It drives a ComfyUI **Boogu** edit\nworkflow: a text prompt plus up to **four reference images** are fed into a\nsingle `TextEncodeBooguEdit` node, and the sampler denoises an empty latent\ninto the edited result.\n\nBoogu is strong at **multi-reference compositing, complex instruct-edits, and\nview synthesis from a single image**. This runner is a drop-in alternative to\n`comfy.klein` / `comfy.qwen_edit_chain` for the `shot_image` (or any\nreference-edit) stage of a bundle.\n\n## Install\n\n```bash\nnpm i dhee-runner-boogu        # into ~/.kshana/runners/<name>/ or your node_modules\n```\n\nDhee discovers it automatically (name matches `dhee-runner-*` and the\n`dhee-runner` keyword is present).\n\n## How it resolves references\n\nMirrors `comfy.klein`: the upstream `shot_image_prompt` JSON carries\n`references[]` (`{ id, type }`). `references[0]` becomes `image_1` (the base),\nthe rest become `image_2..N`. Each entry resolves by `type` against the\nmatching `scope:'all'` collection map:\n\n| `type`      | resolves against |\n|-------------|------------------|\n| `character` | `character_image` |\n| `setting`   | `setting_image`   |\n| `plate`     | `plate_image`     |\n\nA direct `ctx.inputs[id]` path is used as a fallback for single-image\n(non-collection) callers. Boogu accepts a **variable** number of references —\nabsent optional slots are pruned (the `LoadImage` node is deleted and its\n`images.image_N` connection dropped), so no chain-rewiring is needed.\n\n## Node config\n\n```jsonc\n{\n  \"tool\": \"comfy.boogu\",\n  \"config\": {\n    \"workflowPath\": \"workflows/boogu.json\",  // bundle-relative ComfyUI (API-format) workflow\n    \"endpoint\": \"self.local\",                // resolved via ENDPOINT_self_local / COMFYUI_BASE_URL\n    \"width\": 1280,                            // snapped to /16\n    \"height\": 720,\n    \"seed\": 42                               // optional; deterministic when fixed\n  }\n}\n```\n\nOptional overrides (defaults match the bundled `workflows/boogu.json` node ids):\n`promptNodeId` (`enc`), `promptField` (`prompt`), `encNodeId` (`enc`),\n`imageNodeIds` (`[\"img1\",\"img2\",\"img3\",\"img4\"]`), `latentNodeId` (`lat`),\n`seedNodeId` (`ks`), `filenamePrefixNodeId` (`save`).\n\n## Workflow\n\n`workflows/boogu.json` is the canonical API-format graph: `UNETLoader`\n(`boogu_image_edit_fp8_scaled`) + `CLIPLoader` (`qwen3vl_8b_fp8_scaled`,\ntype `boogu`) + `VAELoader` (`ae.safetensors`) → `TextEncodeBooguEdit` with\nfour `LoadImage` slots → `KSampler` (euler/simple, 20 steps, cfg 4.0) →\n`EmptySD3LatentImage` → decode → save. Point `config.workflowPath` at your own\ncopy to swap models/params.\n\n## SDK firewall\n\nDepends only on [`@dheeai/runner-sdk`](https://github.com/dheeai/dhee-runner-sdk)\nand a bundled, dependency-free `ComfyClient` — never on `dhee-core` internals.\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md"}