Skip to content
Beef Docs

Round Models

Round Service Models

Round model binaries are not checked into the repository. They are downloaded during Docker builds or at runtime through EnsureModelFile, which treats missing files, tiny files, and Git LFS pointer stubs as invalid and downloads the canonical artifact.

Model Cache

Round reads models from MODEL_CACHE_DIR, which defaults to /opt/models in the service. Mount persistent storage there when runtime downloads need to survive container restarts.

Docker downloads RetinaFace and LVFace into /opt/models/. Text embedding artifacts are downloaded on first use unless override URLs are configured.

Models

RetinaFace (Face Detection)

  • Path: retinaface/retinaface_mv1_0.25.onnx
  • Source: https://round-models.sexty.dev/retinaface/retinaface_mv1_0.25.onnx
  • Override: ROUND_RETINAFACE_URL
  • Architecture: RetinaFace MobileNet V1 0.25
  • Input: 640x480x3 (HxWxC), BGR format
  • Output: Bounding boxes, confidence scores, and landmarks
  • Preprocessing: Mean subtraction [104, 117, 123]

LVFace-B_Glint360K (Face Embeddings)

  • Path: lvface/LVFace-B_Glint360K.onnx
  • Source: https://round-models.sexty.dev/lvface/LVFace-B_Glint360K.onnx
  • Override: ROUND_LVFACE_URL
  • Input: 112x112 aligned face image produced after RetinaFace detection
  • Output: 512-dimensional face embedding

BAAI/bge-small-en-v1.5 (Text Embeddings)

  • Path: bge-small-en-v1.5/model.onnx and bge-small-en-v1.5/tokenizer.json
  • Source: HuggingFace BAAI/bge-small-en-v1.5
  • Model URL: https://huggingface.co/BAAI/bge-small-en-v1.5/resolve/main/onnx/model.onnx?download=true
  • Tokenizer URL: https://huggingface.co/BAAI/bge-small-en-v1.5/resolve/main/tokenizer.json?download=true
  • Overrides: ROUND_EMBEDDINGS_MODEL_URL, ROUND_EMBEDDINGS_TOKENIZER_URL
  • Input: text, truncated to the model token limit
  • Output: 384-dimensional embedding

Deployment

Model artifacts should be provided by the configured download sources or by a pre-populated MODEL_CACHE_DIR. Do not reintroduce large ONNX binaries into git.

Local Verification

  • cd apps/round && make build
  • cd apps/round && make run-tests
  • cd apps/round && make lint