voice_audio_multi/model_specs/liveavatar.json
Fabio c36510c21e
Some checks failed
Linux Build / Linux cpu (push) Has been cancelled
Linux Build / Linux cpu-clang (push) Has been cancelled
Linux Build / Linux vulkan (push) Has been cancelled
mac-build / macOS CPU (push) Has been cancelled
Nix Build / Nix (cpu) (push) Has been cancelled
Nix Build / Nix (vulkan) (push) Has been cancelled
windows-build / Windows CPU (push) Has been cancelled
Initial import: audio.cpp with Orange Pi documentation
2026-11-04 19:05:22 +01:00

299 lines
7.8 KiB
JSON

{
"schema_version": 1,
"family": "liveavatar",
"display_name": "LiveAvatar",
"description": "LiveAvatar audio-driven avatar video generation using the Wan2.2 S2V architecture.",
"category": "audio_generation",
"status": "experimental",
"tasks": [
"sfx"
],
"modes": [
"offline",
"streaming"
],
"languages": [
"auto"
],
"runtime": {
"tags": [
"cuda",
"gguf",
"stream"
]
},
"capabilities": {
"sfx": [
"prompt_generation"
]
},
"options": {
"request": [
{
"name": "reference_image_file",
"type": "string",
"description": "Reference image path used as the identity/appearance condition.",
"required": true
},
{
"name": "generation_mode",
"type": "enum",
"values": [
"offline",
"liveavatar"
],
"description": "Use whole-clip generation or LiveAvatar blockwise generation.",
"required": false,
"default": "offline"
},
{
"name": "height",
"type": "int",
"description": "Generated frame height; must be a positive multiple of 16.",
"required": false,
"min": 16,
"default": 480
},
{
"name": "width",
"type": "int",
"description": "Generated frame width; must be a positive multiple of 16.",
"required": false,
"min": 16,
"default": 832
},
{
"name": "num_frames",
"type": "int",
"description": "Frames generated per LiveAvatar segment; must be positive and a multiple of 4 in blockwise mode (streaming or generation_mode=liveavatar).",
"required": false,
"min": 1,
"default": 48
},
{
"name": "num_clips",
"type": "int",
"description": "Maximum LiveAvatar clips to generate from the input audio.",
"required": false,
"min": 1,
"default": 1
},
{
"name": "num_inference_steps",
"type": "int",
"description": "Denoising steps; offline generation uses UniPC, blockwise generation uses Euler. The LiveAvatar DMD adapter is designed for 4 steps.",
"required": false,
"min": 1,
"default": 4
},
{
"name": "guidance_scale",
"type": "float",
"description": "Classifier-free guidance scale; LiveAvatar blockwise generation requires 0.",
"required": false,
"min": 0.0,
"default": 0.0
},
{
"name": "batched_cfg",
"type": "bool",
"description": "Run classifier-free guidance in one denoiser graph.",
"required": false,
"default": true
},
{
"name": "sage_attention",
"type": "bool",
"description": "Use CUDA SageAttention when the backend supports it.",
"required": false,
"default": true
},
{
"name": "mem_saver",
"type": "bool",
"description": "Reuse immutable condition data and temporary denoiser graph storage across sequential blocks.",
"required": false,
"default": true
},
{
"name": "denoiser_layerwise",
"type": "bool",
"description": "Run the denoiser in layerwise mode. Offline generation requires batched_cfg=true and guidance_scale > 1.",
"required": false,
"default": false
},
{
"name": "denoiser_layerwise_batch",
"type": "int",
"description": "Layer group size used by layerwise denoising.",
"required": false,
"min": 1,
"default": 16
},
{
"name": "vae_encoder_chunk_size",
"type": "int",
"description": "Cached VAE encoder chunk size.",
"required": false,
"min": 1,
"default": 16
},
{
"name": "vae_decoder_tile_size",
"type": "int",
"description": "Opt-in VAE decoder spatial tile size for large outputs; 0 disables tiling. Enabled tile sizes must be multiples of 8 and larger than the 64-pixel overlap.",
"required": false,
"min": 0,
"default": 0
},
{
"name": "target_cache_blocks",
"type": "int",
"description": "Target KV cache window in block units; 0 keeps the full clip cache.",
"required": false,
"min": 0,
"default": 0
},
{
"name": "vae_cache_f16",
"type": "bool",
"description": "Store cached VAE encoder state in F16.",
"required": false,
"default": true
},
{
"name": "shift",
"type": "float",
"description": "Flow scheduler shift; must be > 0.",
"required": false,
"min": 0.0,
"default": 3.0
},
{
"name": "negative_prompt",
"type": "string",
"description": "Negative prompt for classifier-free guidance.",
"required": false
},
{
"name": "seed",
"type": "int",
"description": "Generation seed.",
"required": false,
"min": 0,
"default": 420
}
],
"session": [
{
"name": "denoiser_weight_streaming",
"type": "bool",
"description": "Keep denoiser transformer blocks in host memory and stage layer groups on the accelerator.",
"required": false,
"default": false
}
],
"load": [
{
"name": "support_gguf",
"type": "string",
"description": "Support GGUF containing text_encoder/audio_encoder tensors and the embedded tokenizer sidecar.",
"required": false,
"default": "Wan2.2-S2V-Support-Q4_K_S-F16.gguf"
},
{
"name": "vae_gguf",
"type": "string",
"description": "Wan video VAE component GGUF file relative to the model root.",
"required": false,
"default": "Wan2.2-S2V-VAE-F16.gguf"
},
{
"name": "denoiser_gguf",
"type": "string",
"description": "Denoiser DiT GGUF file relative to the model root.",
"required": false,
"default": "Wan2.2-S2V-14B-NVFP4-LORA.gguf"
}
]
},
"dependencies": [],
"package_defaults": {
"download": {
"kind": "huggingface_snapshot",
"repo": "audio-cpp/LiveAvatar-GGUF",
"revision": "main",
"gated": false
}
},
"packages": [
{
"id": "liveavatar_nvfp4_lora",
"display_name": "LiveAvatar NVFP4 LoRA GGUF",
"default": true,
"format": "gguf",
"precision": "native",
"target_directory": "LiveAvatar-GGUF",
"files": [
"Wan2.2-S2V-Support-Q4_K_S-F16.gguf",
"Wan2.2-S2V-VAE-F16.gguf",
"Wan2.2-S2V-14B-NVFP4-LORA.gguf"
]
}
],
"sources": [
{
"format": "gguf",
"roots": {
"model": "."
},
"files": {
"tokenizer_model": "model:tokenizer/spiece.model"
},
"tensors": {
"text_encoder_weights": {
"source": "model:Wan2.2-S2V-Support-Q4_K_S-F16.gguf",
"prefix": "text_encoder"
},
"audio_encoder_weights": {
"source": "model:Wan2.2-S2V-Support-Q4_K_S-F16.gguf",
"prefix": "audio_encoder"
}
}
},
{
"format": "gguf",
"roots": {
"model": "."
},
"tensors": {
"vae_weights": {
"source": "model:Wan2.2-S2V-VAE-F16.gguf",
"prefix": "vae"
}
}
},
{
"format": "gguf",
"roots": {
"model": "."
},
"tensors": {
"denoiser_weights": {
"source": "model:Wan2.2-S2V-14B-NVFP4-LORA.gguf"
}
}
}
],
"ui": {
"recommended_package": "liveavatar_nvfp4_lora",
"tags": [
"SFX",
"GGUF",
"Stream"
],
"docs": [
"docs/models/liveavatar.md"
]
}
}