sammykumar-ComfyUI-SwissArmyKnife/dev-docs/VENDORING.md

Vendoring Notes

This repository vendors a minimal subset of the VACE-Annotators project (Apache-2.0) so ComfyUI users can run the scribble annotator without installing the full upstream repo.

Vendored Components

File	Description	Upstream Source
nodes/vace_annotators/annotator_models/scribble.py	ResNet generator architecture plus preprocessing/postprocessing helpers. As of this update it also vendors the official ContourInference graph to mirror upstream behavior.	Derived from the scribble generator in ali-vilab/VACE-Annotators (Apache-2.0).
nodes/vace_annotators/annotator_models/__init__.py	Shim exporting loader + helpers.	Local glue code referencing the vendored generator.
nodes/vace_annotators/scribble_loader.py	Loader, device handling, caching, and error plumbing.	Local adaptation based on SwissArmyKnife requirements.

Updating the Vendored Code

1. Fetch the latest scribble generator implementation from the upstream repository.
2. Preserve the Apache-2.0 license header and attribution when copying/updating files.
3. Keep imports self-contained (no upstream-relative imports remain after vendoring).
4. Run tests/annotators/test_scribble_inference.py to ensure fallback + optional model inference still work.
5. Document changes in docs/nodes/vace-annotators/scribble/README.md when the vendored code diverges from upstream behavior.

Additional Assets

• tests/data/sample_scribble_input.png is a synthetic 128×128 RGB gradient used by the smoke tests to create deterministic scribble outputs.
• Test artifacts are written to tests/output/ for visual inspection.

The upstream project is licensed under Apache-2.0. See the repository license for full terms.