README.md

---
license: other
library_name: pytorch
tags:
  - audio-to-face
  - flame
  - arkit
  - hubert
---

# FaceAnimator A2F runtime assets

这是 `FaceAnimator_a2f_delivery` 的运行资产包。目录层级与代码实际加载路径一致；将本目录内容合并到代码仓库根目录即可，不需要改路径。

## 默认 HTTP fused 链路必需

- `v1_inference/checkpoints/fix_b3_1009_step74000.pt`
- `v1_inference/models/chinese-hubert-base/{config.json,preprocessor_config.json,pytorch_model.bin}`
- `FaceAnimator-flame2bs/param_net/outputs/best_temporal_flame2bs.pth`
- `FaceAnimator-flame2bs/vertice_fit/FLAME/geometry/landmark_embedding.npy`
- `FaceAnimator-flame2bs/vertice_fit/utils/new_arkit_basis_matrix.npy`
- `FaceAnimator-flame2bs/vertice_fit/FLAME/geometry/generic_model.pkl`：未包含，见下方许可证说明

## 可选转换权重

- `best_frame_flame2bs.pth`：离线脚本默认使用，HTTP `--f2b-model frame` 使用
- `best_mlp_flame2bs.pth`：HTTP/离线 `mlp` 模式使用

## FLAME 许可证边界

`generic_model.pkl` 受 FLAME 模型许可证约束，本包不包含，也不应上传至公开 Hugging Face 仓库。使用者需自行从 FLAME 官方渠道取得，并放到：

`FaceAnimator-flame2bs/vertice_fit/FLAME/geometry/generic_model.pkl`

其正确版本的预期信息为：大小 `53023716` 字节，md5 `cfc3b95159b2a8981ebc347170202ba5`。

## 完整性校验

`SHA256SUMS` 覆盖包内全部模型、配置与数值资产。Linux 下在本目录执行：

```bash
sha256sum -c SHA256SUMS
```

`config.json` 仅将原始 `_name_or_path` 清理为相对名称 `chinese-hubert-base`，模型结构与权重未改动。

代码仓库不在本资产包内；对应代码分支为 `feat/a2f-service-delivery`。