@melite/models-kimodo 0.1.4-alpha → 0.1.5-pre-alpha

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,44 @@
1
+ ---
2
+ description: NVIDIA Kimodo-SOMA text-to-pose motion family — SOMA-77 NPZ clips plus an optional rigged-GLB bake at 30 fps.
3
+ kind: package-library
4
+ ---
5
+
6
+ # kimodo
7
+
8
+ kimodo registers the NVIDIA Kimodo-SOMA family (form `form_motion_kimodo`, genre `motion`): text-to-motion generation over the SOMA-77 skeleton, shipped as pose NPZ clips, with an optional bake onto a rigged GLB. Weights come from the nvidia/Kimodo-SOMA-RP-v1.1 release; the family provisions `skin_standard.npz`, the SOMA-77 skin template.
9
+
10
+ ## The compose action
11
+
12
+ `compose` outputs two handles: `motion_npz` (kind MOTION) and `animated_glb` (kind GLB). The build wires KimodoLoader → KimodoTextToPose, then — when chained motion inputs or a rigged GLB are present — RaySomaxBake at 30 fps.
13
+
14
+ Params: `prompt` (required — the family's one relation), `duration_sec` [1, 10] (default 5), `diffusion_steps` [10, 200] (default 25), `num_samples` [1, 4] (default 1), `num_transition_frames` [0, 60] (default 10), `cfg_type` (`separated` / `regular` / `nocfg`; default `separated`), `cfg_weight_a` and `cfg_weight_b` [0, 15] (defaults 2.5 and 5), the chaining inputs `motion_npz`, `motion_prompts`, `motion_constraints`, `preview_glb`, and `seed` (seed-sentinel rule; default 42).
15
+
16
+ ## Recipes
17
+
18
+ Two recipe rows plus the no-op: `draft` (10 diffusion steps — fast iteration) and `polished` (200 steps — final quality).
19
+
20
+ ## Model Experience
21
+
22
+ ### Request context and condition
23
+
24
+ A run needs the prompt and the duration; everything else has a declared default. Chained `motion_npz` / `motion_prompts` / `motion_constraints` extend or stitch a clip; `preview_glb` carries the rigged mesh the bake arm dresses.
25
+
26
+ #### What the model sees
27
+
28
+ The prompt, duration, step count, the CFG type and weight pair, any chained motion inputs, and the optional rigged GLB; the graph is the loader → text-to-pose chain above, with the bake at 30 fps when rigged output is requested.
29
+
30
+ #### Token effect
31
+
32
+ Zero-direct: the action composes an engine graph, not a token stream. No value this family declares is measured in model tokens.
33
+
34
+ #### KV Cache effect
35
+
36
+ Independent: each run is self-contained; no shared context is declared.
37
+
38
+ ## Known Limitations and Deferred Work
39
+
40
+ - **Single skeleton** — SOMA-77 only; no retargeting or skeleton-choice surface is declared.
41
+ - **Fixed bake rate** — RaySomaxBake runs at 30 fps; the params surface offers no fps override.
42
+ - **Live behavior unobserved** — defaults and bounds are documented from the DECL and the action build, not verified against the running model.
43
+
44
+ Exports: the plugin root, `./package.json`.
package/lib/index.d.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  import type { Plugin } from "@deepseek-ai/cordis";
2
- import type { ModelDecl } from "@melite/comfyui-cordis/model-contract";
2
+ import type { ModelDecl } from '@melite/comfyui-card-kit/model-contract';
3
3
  export declare const DECL: ModelDecl;
4
4
  export declare const family: Plugin;
5
5
  export { compose } from "./actions.js";
6
+ export { family as default };
6
7
  //# sourceMappingURL=index.d.ts.map
package/lib/index.js CHANGED
@@ -92,9 +92,32 @@ export const DECL = {
92
92
  "size_bytes": 531434
93
93
  }
94
94
  ],
95
+ "snapshot_provisions": [
96
+ {
97
+
98
+ // demand is satisfied only by a row that FETCHES or a stated
99
+ // placement — the source repo id alone composes no download
100
+
101
+ // owner's HF CLI; the on-disk tree matches upstream file for
102
+ // file.
103
+ "name": "Kimodo-SOMA-RP-v1.1",
104
+ "folder": "avatar/kimodo",
105
+ "repo_id": "nvidia/Kimodo-SOMA-RP-v1.1",
106
+ "revision": "6c9233af1180b8151e3c4703477104af5dce9dd5",
107
+ "allow_patterns": [
108
+ "config.yaml",
109
+ "model.safetensors",
110
+ "stats/**"
111
+ ]
112
+ }
113
+ ],
95
114
  "lane_inputs": {
96
115
  "model_path": "Kimodo-SOMA-RP-v1.1"
97
116
  },
117
+ // THE DECLARED HOME (the lane-presence cure): the store folder this
118
+ // pack-specific lane file lives in — the run gate probes it at press
119
+ // instead of dying untyped at the engine.
120
+ "lane_homes": { "model_path": "avatar/kimodo" },
98
121
 
99
122
  // the GAP-7 shape on the legacy lanes): the card's compose seat has
100
123
  // refused this field since the merge, imperatively, while the bench
@@ -112,6 +135,17 @@ export const DECL = {
112
135
  },
113
136
  ],
114
137
  },
138
+ // THE LANE SURFACE (the z-image precedent): exactly the knobs the
139
+ // motion card serves — the prompt, the sampling tail, and the
140
+ // motion-segment inputs.
141
+ "params": [
142
+ "prompt", "seed",
143
+ "duration_sec", "diffusion_steps",
144
+ "num_samples", "num_transition_frames",
145
+ "cfg_type", "cfg_weight_a", "cfg_weight_b",
146
+ "motion_npz", "motion_prompts", "motion_constraints",
147
+ "preview_glb",
148
+ ],
115
149
  // the compose action the motion card binds (the motion_t1
116
150
  // lane tree).
117
151
  "actions": [compose],
@@ -124,4 +158,9 @@ export const family = {
124
158
  },
125
159
  };
126
160
  export { compose } from "./actions.js";
161
+ // The Loader-row face: DSH loads plugin rows by bare specifier and
162
+ // unwraps `exports.default ?? exports` (vendor/cordis_plugins/loader
163
+ // unwrapExports) — the default export IS the row-loadable plugin. The
164
+ // named `family` stays the library face (engine loadFamilies).
165
+ export { family as default };
127
166
  //# sourceMappingURL=index.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@melite/models-kimodo",
3
- "version": "0.1.4-alpha",
3
+ "version": "0.1.5-pre-alpha",
4
4
  "license": "SSPL-1.0",
5
5
  "type": "module",
6
6
  "exports": {
@@ -11,8 +11,7 @@
11
11
  "./package.json": "./package.json"
12
12
  },
13
13
  "dependencies": {
14
- "@melite/comfyui-card-kit": "0.1.4-alpha",
15
- "@melite/comfyui-cordis": "0.1.4-alpha"
14
+ "@melite/comfyui-card-kit": "0.1.5-pre-alpha"
16
15
  },
17
16
  "devDependencies": {
18
17
  "@types/node": "^22.20.0",