SCAIL AIST Library

SCAILAISTLibraryLoader is where the AIST++ dance data enters the pack. It loads the chunked library - roughly 44,000 half-second dance clips cut from professional AIST++ performances, tagged by genre and energy. The output, an AIST_LIBRARY, is the required input for SCAILAISTBeatDance (the reactive beat-triggered choreography node) and SCAILAISTChunkPreview (the eyeball-a-chunk debug node). If you want reactive real-dance motion, this loader is step one.

Two inputs, and they're about as simple as it gets:

• library_path - a string pointing at the folder holding the chunk data plus its index.json. The default is auto-computed to ComfyUI/models/aist_chunks under your install. The tooltip's advice is the right call: leave it defaulted and let the download happen.
• auto_download - true by default. If index.json isn't found at the path, the node pulls aist_chunks_v2.tar.gz from HuggingFace (ckinpdx/aist_chunks), extracts it, and flattens the folder structure. ~220MB, progress bar in the console, cleaned up after.

The loader returns library - an AIST_LIBRARY - after printing how many genres and total chunks it loaded, so you get immediate confirmation the data's good. Nothing else in the pack consumes this type; that's the entire point of keeping chunk and full-sequence libraries separate.

The distinction matters more than it looks. There are two AIST loaders: this one (chunks, ~220MB, feeds the reactive beat-dance) and SCAILAISTFullLoader (full uncut sequences, ~200MB, feeds SCAILAISTFullSequence). Plug the wrong one into a downstream node and the wire won't match - different custom types. Decide which mode you're building and install only the matching library, unless you really want both on disk (~420MB total).

Installing and troubleshooting

Same pack-wide story: clone ckinpdx/ComfyUI-SCAIL-AudioReactive into ComfyUI/custom_nodes, pip install -r requirements.txt, restart. ComfyUI Manager works too - search the pack title.

The failure mode you'll actually meet: auto_download is on but the download dies partway (it retries, but network hiccups happen), leaving a partial folder with no index.json. The node then re-downloads on the next run. If it keeps failing, delete ComfyUI/models/aist_chunks entirely and let it start fresh - a half-extracted tar is the usual culprit. The libraries only download once; after that the loader just reads the index and gets out of your way.