@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 +44 -0
- package/lib/index.d.ts +2 -1
- package/lib/index.js +39 -0
- package/package.json +2 -3
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
|
|
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.
|
|
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.
|
|
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",
|