QVAC documents
cacheDirectory but not the worker home.
This page was checked against @qvac/sdk 0.22.0 source and a real Redact run on macOS.
Nearest official pages: Configuration and Download lifecycle.The model cache
Model weights go tocacheDirectory.
You set it in a QVAC config file, and point the SDK at that file with QVAC_CONFIG_PATH before the first import("@qvac/sdk"), because the configuration is read once when the SDK starts.
.qvac/config.json
76264cc45d44f541_laya-Q8_0.gguf.
A later loadModel() with the same model constant checks this directory first and loads from disk without contacting the registry.
The worker home
The SDK runs inference in a separate worker process. That worker keeps its own state under<home>/.qvac/: a registry-corestore database of model metadata, and a tmp directory for transient files such as decoded images.
<home> is SNAP_USER_COMMON if that variable is set, otherwise HOME.
So by default every QVAC app on your machine shares ~/.qvac.
Setting SNAP_USER_COMMON to a directory inside the project gives each app its own worker home.
Redact’s service, evaluation and offline proof do this, so a broken or missing ~/.qvac (for example a symlink to an unmounted drive) can’t stop them.
The lesson 02 OCR script doesn’t, so it does use ~/.qvac, and fails with ENOENT … stat "…/.qvac" if that is a broken link; replace it with a real folder.
The service’s layout looks like this:
Clearing it
Deletingmodels/ forces a fresh download on the next load.
Deleting runtime-home/ resets registry metadata and temporary files.
Neither touches your source code or documents.
Related
- Configuration (official)
- Download lifecycle (official)
- How to clear Redact’s model cache