openpilot/tinygrad_repo/extra/huggingface_onnx
Vehicle Researcher c5d5c5d1f3 openpilot v0.10.1 release
date: 2025-10-24T00:30:59
master commit: 405631baf9685e171a0dd19547cb763f1b163d18
2025-10-24 00:31:03 -07:00
..
huggingface_manager.py openpilot v0.10.1 release 2025-10-24 00:31:03 -07:00
README.md openpilot v0.10.1 release 2025-10-24 00:31:03 -07:00
run_models.py openpilot v0.10.1 release 2025-10-24 00:31:03 -07:00

HuggingFace ONNX

Tool for discovering, downloading, and validating ONNX models from HuggingFace.

Extra Dependencies

pip install huggingface_hub pyyaml requests onnx onnxruntime numpy

Huggingface Manager (discovering and downloading)

The huggingface_manager.py script discovers top ONNX models from HuggingFace, collects metadata, and optionally downloads them.

# Download top 50 models sorted by downloads
python huggingface_manager.py --limit 50 --download

# Just collect metadata (no download)
python huggingface_manager.py --limit 100

# Sort by likes instead of downloads
python huggingface_manager.py --limit 20 --sort likes --download

# Custom output file
python huggingface_manager.py --limit 10 --output my_models.yaml

Output Format

The tool generates a YAML file with the following structure:

repositories:
  "model-name":
    url: "https://huggingface.co/model-name"
    download_path: "/path/to/models/..."  # when --download used
    files:
      - file: "model.onnx"
        size: "90.91MB"
total_size: "2.45GB"
created_at: "2024-01-15T10:30:00Z"

Run Models (validation)

The run_models.py script validates ONNX models against ONNX Runtime for correctness.

# Validate models from a YAML configuration file
python run_models.py --validate huggingface_repos.yaml

# Debug specific repository (downloads and validates all ONNX models)
python run_models.py --debug sentence-transformers/all-MiniLM-L6-v2

# Debug specific model file
python run_models.py --debug sentence-transformers/all-MiniLM-L6-v2/onnx/model.onnx

# Debug with model truncation for debugging and validating intermediate results
DEBUGONNX=1 python run_models.py --debug sentence-transformers/all-MiniLM-L6-v2/onnx/model.onnx --truncate 10