Repository navigation
Releases
Releases · samarthpatel24/airlock
v0.1.0
Immutable
release. Only release title and notes can be modified.
First release. airlock checks an AI model before it enters an air-gapped network, and again on the offline side before it runs.
What it does
airlock seal(online): refuses formats that can run code, matches every file to a pinned Hugging Face commit, signs a manifest with cosign.airlock verify(offline): checks the signature and every file with no network and no other tools, writes a Markdown report.airlock smoke: asks the running model server a question with a known answer.airlock check: format checks only.airlock zarf: writes a Zarf package that runsverifyduring deploy, so a swapped model never starts.
GGUF (v2, v3) and safetensors are parsed in full; pickle and unknown file types are refused. The verifier uses only the Go standard library.
Install
curl -LO "https://github.com/samarthpatel24/airlock/releases/download/v0.1.0/{airlock_linux_amd64,checksums.txt,checksums.txt.sigstore.json}"
cosign verify-blob checksums.txt --bundle checksums.txt.sigstore.json --certificate-identity https://github.com/samarthpatel24/airlock/.github/workflows/release.yml@refs/tags/v0.1.0 --certificate-oidc-issuer https://token.actions.githubusercontent.com
sha256sum --ignore-missing -c checksums.txtBinaries for linux and darwin, amd64 and arm64. They are reproducible: CGO_ENABLED=0 go build -trimpath -buildvcs=false with Go 1.27.3 gives the same SHA-256 as checksums.txt.
Tested
- Qwen2.5 0.5B Instruct, GGUF Q4_K_M, commit
9217f5db: seal, verify, llama.cpp smoke test, and a Zarf v1.0.0 deploy where a poisoned copy is refused. - safetensors,
hf-internal-testing/tiny-random-gpt2at71034c5d: seal and verify pass; changed header and weight bytes are refused.
Not covered yet
See the threat model. Planned work is in issues, including chat template inspection, rollback protection, an offline vulnerability re-scan and delta updates.