deployments/huggingface/README.md

HuggingFace Deployment

Deploy SAM3 to HuggingFace Inference Endpoints.

Quick Deploy

./deployments/huggingface/deploy.sh

Configuration

• Registry: sam3acr4hf.azurecr.io
• Image: sam3-hf:latest
• Endpoint: sam3-segmentation
• Organization: Logiroad
• Hardware: NVIDIA A10G (24GB VRAM)

Manual Deployment

# Build and push
docker build -t sam3acr4hf.azurecr.io/sam3-hf:latest -f docker/Dockerfile .
az acr login --name sam3acr4hf
docker push sam3acr4hf.azurecr.io/sam3-hf:latest

# Restart endpoint
python3 -c "from huggingface_hub import HfApi; api = HfApi(); e = api.get_inference_endpoint('sam3-segmentation', namespace='Logiroad'); e.pause(); e.resume()"

Testing

python3 scripts/test/test_api.py

Endpoint URL

https://p6irm2x7y9mwp4l4.us-east-1.aws.endpoints.huggingface.cloud