Repository navigation
Scans now contact PyPI by default. When a scan finds exact
requirements.txtpins such astransformers==5.13.1, it requests each pinned package name and version frompypi.orgto read that release's declared license. Nothing else is sent. The GitHub Action andaisbom scoredo the same.Local scans can now contact Hugging Face. A local model file in the Hugging Face cache layout, or next to a
config.jsonwhose_name_or_pathnames a repo, makes the scan fetch that repo's file list and model card fromhuggingface.co. What is sent is the repo id and, for a cached file, the commit from its path. The file's hash is compared on your machine. IfHF_TOKENis set, it is sent tohuggingface.co, as forhf://scans. A tree with neither kind of file makes no request. Pass--no-hf-lookupor setAISBOM_NO_HF_LOOKUP=1to turn this off.
--offlineturns off every network request: both of these, the OSV lookup, telemetry and the update check.AISBOM_OFFLINE=1does the same.Unreadable model files now exit
1instead of0. A file that no parser could read — a git-LFS pointer stub, an empty file, a truncated stream, a file in no recognised format — was reported asRisk: LOWwith a confident framework label and passed as a clean scan. It is now reported as an error and exits1. If your tree contains such files, a pipeline that passes today will start failing. That is the intended signal: those files were never examined, and--fail-on-riskwas readingLOWon an artifact nothing had opened. The exit-code table in the README has always documented exit1for "a file failed to parse".
New
-
Dependency licenses from PyPI. Library components parsed from
requirements.txtnow carry the license their package declares on PyPI, in the standardlicenses[]field, with anaisbom:license:sourceproperty ofpypi. Only exact==pins are looked up. Ranges such astorch>=2.0don't say which release is installed, so they are skipped and counted in the scan summary. The PEP 639License-Expressionis used first, then a valid SPDX identifier or expression in thelicensefield, then a classifier that names exactly one license. A license text pasted into the field, or a classifier such asBSD Licensethat doesn't say which BSD, gives no license rather than a guessed one.In SPDX 2.3 output, SPDX-valid values become
licenseDeclared, andlicenseConcludedstaysNOASSERTION. The license never affects the legal-risk status of model files. Results are cached in~/.aisbom/pypi_license_cache.json: 30 days for a resolved license, 24 hours for a package that declares none. If PyPI can't be reached, those dependencies carry no license, the scan prints a warning, and exit codes are unchanged. The lookup runs only for CycloneDX and SPDX 2.3 output, the two formats with a field for it. -
Model cards for local files downloaded from Hugging Face. A local model file can now get the same
modelCarddata anhf://scan produces. The evidence is either the Hugging Face cache path (models--<org>--<name>/snapshots/<commit>/) or aconfig.jsonbeside the file whose_name_or_pathis a repo id. The card is added only if the file's hash appears in that repo's file list, and anaisbom:hf:matchproperty records which evidence matched. A file whose bytes aren't in the repo, such as a fine-tune that still names its base model, gets no card. Neither does a file that matches more than one repo. The lookup runs for CycloneDX 1.7 and SPDX 3.0 output, and inaisbom score. -
--offlinefor air-gapped scans.aisbom scan --offlineandaisbom score --offlinemake no network access: no PyPI, OSV or Hugging Face lookup, no telemetry and no update check.AISBOM_OFFLINE=1does the same for any command.hf://andhttps://targets and--shareare refused with exit1, because each needs the network. The SBOM is otherwise the same, minus the dependency licenses, CVE statements and model cards those lookups would have added. The air-gapped guide now recommends it.
Fixed
-
Common non-pickle weights files no longer score
CRITICAL (Legacy Binary). A.pt/.pth/.binthat was not a zip, a pickle, or a path config fell into a catch-all that rated it CRITICAL and exited2. In a scan of the 500 most-downloaded Hugging Face models, every HIGH or CRITICAL result came from that catch-all and none was a payload. Three weights formats are now recognised by their content and ratedLOW, like SafeTensors and GGUF, because none is a pickle or runs code on load:- CTranslate2
model.bin, which covers every faster-whisper model: recognised by its version header and spec name (WhisperSpec, …). - OpenVINO IR
.bin: recognised only when its same-name.xmlgraph sits beside it. Onhf://scans, the repo listing is checked first, so a.binwith no graph costs no extra request. - Core ML
weight.bininside an.mlpackageor compiled.mlmodelc: recognised by its weight-blob header.
Their components carry
aisbom:formatvaluesctranslate2,openvinoandcoreml. The pickle scan still runs first, so a payload under any of these names is still CRITICAL. A.binmatching none of them is stillCRITICAL (Legacy Binary). With recursivehf://scans (below), this is what keepshf://sentence-transformers/all-MiniLM-L6-v2andhf://google-bert/bert-base-uncasedfrom failing on theiropenvino/andcoreml/folders. - CTranslate2
-
ONNX, SafeTensors and GGUF files with a PyTorch extension are inspected as what they are. Dispatch used to be by extension alone, so an ONNX model saved as
.ptwent through the pickle path and came outCRITICAL (Legacy Binary). Such a file now goes to its own format's inspector. The component is markedidentified_by_contentin its details. -
A failed read of a torch checkpoint is an error, not
CRITICAL. Python's zip check swallows network errors, so one failed Range request on a remote checkpoint made an ordinary torch zip look like an unknown binary. A file that starts with a zip header now gets a second check. If it still won't open, it is reported as unreadable (TruncatedStream, exit1) with the underlying error, never as a verdict. A local truncated zip gets the same treatment, so itsunreadable_typechanges fromUnrecognizedFormattoTruncatedStream. -
scan hf://now scans model files in subfolders. The Hugging Face file listing was read withoutrecursive=trueand only its first page was used, so every supported file under a folder (onnx/,unet/,text_encoder/, …) was skipped without a word. A repo whose weights all live in subfolders scanned as "No AI models found" and exited0. The listing now reaches every depth and follows every page. A failure on any page fails the scan the way a first-page failure always has, and a next-page link that leaveshuggingface.cois refused, since the token is sent with each page. Expect more components, and possibly new findings, from repos you already scan. -
"Could not read it" is no longer reported as "read it, it's clean".
LOWasserts that AIsbom opened an artifact and found nothing dangerous; for a file no parser could read, the honest answer is different. Five inspectors already recorded their own parse failure internally and nothing ever consulted it, so a truncated zip, a two-byte pickle, 200 bytes of random data named.safetensors, and a plain-text.ptall gradedLOWat exit0.Such files now land in the scan's error list, print in their own Could not read section, and exit
1. They still appear in the SBOM — an auditor needs to see the file was present — but carry no framework label and no risk verdict, marked withaisbom:unreadableandaisbom:unreadable_typeproperties. A format label is applied only when that format's parser actually succeeded, so random bytes are no longer described as SafeTensors.aisbom scoreconsequently refuses to grade a scan containing one.A git-LFS pointer gets its own message naming the remedy (
git lfs pull), since that is a configuration problem rather than a corrupt artifact and is the most common unreadable.safetensorsin practice. -
UNKNOWNverdicts have a consequence. An unparseable GGUF, Keras or ONNX file was already labelled honestly, butUNKNOWNscores belowLOWin the risk ranking, so those scans exited0and the file rated safer than a clean model. They now exit1like every other unreadable file. -
A text
.ptor.binis no longer classified as a Python path config..pthis legitimately also a Python path-configuration format, and any text file in those three extensions inherited that classification — so an HTML error page saved over a checkpoint scoredLOW. The classification is now.pth-only and validates against that format's actual spec (importstatements and bare paths), verified against every.pthfile in a real virtualenv. -
A SafeTensors header longer than the file is rejected before it is read. Random bytes decode to an astronomical declared header length; that is now bounded by the bytes actually present, which replaces an internal
OverflowErrorwith a message saying what is wrong with the file.
Changed
-
hf://components in subfolders are named by their path in the repo.onnx/model.onnxandopenvino/model.onnxare now two distinguishable components rather than two namedmodel.onnx. Files at the repo root keep the bare filename they had before, so existingaisbom diffbaselines still match them. -
A file listing that has to stop early is an error. The listing is capped at 100 pages (about 100,000 entries) so a pathological repo cannot hold a scan forever. If the cap is reached, everything listed is still scanned, and the scan reports
ListingTruncatedand exits1instead of passing on a partial view.cli_errortelemetry carriesListingTruncatedas itserror_type. -
Telemetry reports unreadable files.
cli_scangainsunreadable_countandunreadable_types(a closed set:LfsPointer,EmptyFile,TruncatedStream,UnrecognizedFormat), so a wave of failed downloads is distinguishable from a wave of clones missinggit lfs pull. Paths are never sent.AISBOM_NO_TELEMETRY=1still turns telemetry off.
What's not changing
Pickle payload detection works as in 1.6.0. Each format newly recognised in this release is matched only after the pickle scan has found nothing. Output formats and the meaning of each exit code are the same as in 1.6.0. Unreadable files now carry no framework label or risk verdict, as described above. Every other SBOM change is an addition: dependency licenses, model cards for matched local files, more components from subfolders, and new aisbom:format values.