【Python】大容量AIモデル sha256整合性検証&安全ガードCLI v1.0
- Digital500 JPY


「9.4GBのAIモデルをダウンロードしたのに、なぜかComfyUIやローカルLLMでエラーになる…」 調べたらファイルサイズは完全に一致しているのに、中身の一部が欠損・破損していた——そんなサイレント破損を1コマンドで検知・防止する実用CLIツールキットです! ■ 収録内容(ZIP形式 / 即実行可能) 1. model_integrity_guard.py(標準ライブラリのみ・pip追加インストール不要) 2. sample_models/(動作確認用テストデータ&マニフェスト例) 3. README.md(運用コマンドガイド) ■ 主な機能(3つのサブコマンド) ・`init`: モデルフォルダ配下の .safetensors / .gguf / .ckpt / .pt 等を8MBストリーミングで走査し、厳密なバイト数+sha256台帳(models_manifest.json)を自動生成 ・`verify`: 台帳と実ファイルを高速照合し、「正常 / サイズ不一致 / sha256破損(CORRUPT) / 欠損(MISSING)」を即座に特定 ・`hash`: 単一ファイルのsha256ハッシュと厳密バイト数を低メモリで表示 ■ こんな方におすすめ ・ComfyUIやOllama/llama.cppで数GB〜数十GBのモデルを扱う方 ・NASや外付けSSDへのバックアップ後に「モデルが壊れていないか」一括チェックしたい方 ・自動DLパイプラインの安全ガードを組み込みたい開発者 ■ 関連技術解説(Zenn記事) 実体験に基づく原因解説はこちらで無料公開中です👇 https://zenn.dev/mana_mrl/articles/a892f8cea7d925
더보기

