Civitai Data Manager

Civitai Data Manager is a lightweight Python command-line tool to locally archive, index, and browse metadata for models in SafeTensors format that originate from Civitai. It processes local model files, fetches corresponding metadata and previews from Civitai, and produces a portable HTML browser plus JSON backups for each model.

Key Features

• Backup model metadata and SHA256 hashes extracted from SafeTensors files
• Fetch Civitai model and model-version data and store as JSON per model
• Optional preview image download and per-image JSON metadata generation
• Generate an interactive static HTML browser (index and per-model pages) with search and grouping by model type
• Incremental updates: only process models with newer Civitai timestamps
• CLI-driven with configuration file support, rate-limiting delays, and processed-files tracking for selective updates

Use Cases

• Archive and document local collections of Stable Diffusion models (.safetensors) with Civitai metadata
• Create an offline, browsable catalog of models and previews for curation or sharing within a team
• Maintain periodic backups of trigger words, tags, and model-version details to recover metadata for removed models

Limitations and Considerations

• Only supports models in .safetensors format and relies on Civitai model/version endpoints for metadata
• Not a graphical application; operation is CLI-based and intended for scripted or manual runs
• Rate-limiting delays are conservative by default and can slow large batches; disabling them may risk API throttling
• Output is file-based (JSON and static HTML); there is no built-in database backend or server component

Civitai Data Manager is suitable for users who need a simple, reproducible way to back up and browse Civitai model metadata locally. It prioritizes portability, simplicity, and compliance with the official Civitai API usage patterns.