Imported from thangngny/AI_Avatar (
AGENTS.md). Install upstream withnpx skills add thangngny/AI_Avatar. Copyright stays with the author.
AGENTS.md
MANDATORY STARTUP
Before modifying or running this repository:
- Confirm the Git branch is main (
git branch --show-current). - Read SYSTEM_CONTROL_BOARD.md (the shared system board).
- Read config/render_truth.json (the only runtime quality/lip-sync truth).
- Treat render_truth.json as the single source of truth for locked render parameters. Do not reintroduce quality defaults elsewhere.
avatar_id,script,master audio, andoutput pathare variable job inputs only — never part of the locked truth.- Never confuse a RAW avatar source with a PREPARED avatar.
- RAW source = the original camera
.mp4/.mov/photo before MuseTalk preprocessing →data/input/avatar_sources/(and lineage indexdata/avatar_sources.json). - PREPARED avatar =
data/avatars/<avatar_id>/(full_imgs/,coords.pkl,latents.pt,mask/,mask_coords.pkl,avator_info.json) — the generated asset the renderer actually consumes. - A
data/avatars/.uploads/*.mp4is a RAW source, not a prepared avatar.
- RAW source = the original camera
- Do not use experimental pipelines (
experiments/,archive/, the LatentSync copy) unless explicitly requested. Production runtime is MuseTalk v1.5 only. - If not on
main, STOP and return tomainbefore normal production work. - Preflight (optional, no models loaded):
python system_status.py.
Do not duplicate the control board here. SYSTEM_CONTROL_BOARD.md is authoritative;
this file only points to it.
