Skip to content

chore: self-host model downloads from GitHub assets release#15

Merged
tyvsmith merged 1 commit intomainfrom
self-host-models
Mar 22, 2026
Merged

chore: self-host model downloads from GitHub assets release#15
tyvsmith merged 1 commit intomainfrom
self-host-models

Conversation

@tyvsmith
Copy link
Copy Markdown
Owner

Summary

  • Created a new GitHub release (assets) containing all 4 ONNX model files
  • Updated models/manifest.toml to download models from our own repo instead of third-party sources

What changed

All model download URLs in models/manifest.toml now point to:

https://github.com/tyvsmith/facelock/releases/download/assets/<filename>

Previously they pointed to visomaster/visomaster-assets (3 models) and HuggingFace (1 model).

SHA256 checksums are unchanged — same files, just self-hosted.

Models in the assets release

Model Size Purpose
scrfd_2.5g_bnkps.onnx 3 MB Face detection (default)
w600k_r50.onnx 166 MB Face embedding (default)
det_10g.onnx 17 MB Higher accuracy detection (optional)
glintr100.onnx 249 MB Higher accuracy embedding (optional)

Why

Eliminates dependency on third-party hosting for model downloads. Users no longer need to rely on visomaster's GitHub releases or HuggingFace being available.

Point all 4 ONNX model download URLs at the new 'assets' release on
this repo instead of third-party locations (visomaster GitHub release
and HuggingFace). SHA256 checksums are unchanged.
Copilot AI review requested due to automatic review settings March 22, 2026 04:29
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates Facelock’s ONNX model manifest to self-host model downloads from this repository’s GitHub Releases (tag assets), removing reliance on third-party hosting.

Changes:

  • Updated all model url entries in models/manifest.toml to https://github.com/tyvsmith/facelock/releases/download/assets/<filename>.
  • Updated the manifest header comments to reflect the new hosting location and checksum verification behavior.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread models/manifest.toml
Comment on lines +3 to +4
# Models are hosted in the GitHub "assets" release:
# https://github.com/tyvsmith/facelock/releases/tag/assets
Copy link

Copilot AI Mar 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Using a non-versioned GitHub release tag (assets) makes these model URLs effectively mutable (tags/assets can be replaced). If the release assets ever change, older binaries will download the new file and then fail SHA256 verification, breaking facelock setup for existing versions. Consider switching to a versioned/immutable tag (e.g. vX.Y.Z-models) or otherwise guaranteeing assets is append-only and never rewritten.

Copilot uses AI. Check for mistakes.
Comment thread models/manifest.toml
Comment on lines +3 to +6
# Models are hosted in the GitHub "assets" release:
# https://github.com/tyvsmith/facelock/releases/tag/assets
#
# The sha256 checksums remain the same regardless of hosting source.
# The sha256 checksums are verified at download time and at daemon startup.
Copy link

Copilot AI Mar 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After changing the canonical model hosting location to the assets release, some docs still reference the old hosting/tag (v0.1.0-models) and visomaster URLs (e.g. docs/testing-roadmap.md, docs/troubleshooting.md, book/src/troubleshooting.md). Updating those references in the same PR would avoid confusing users troubleshooting download failures.

Copilot uses AI. Check for mistakes.
@tyvsmith tyvsmith merged commit 3651972 into main Mar 22, 2026
7 checks passed
@tyvsmith tyvsmith deleted the self-host-models branch March 22, 2026 04:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants