Overview

Full name
docker.io/kserve/huggingfaceserver
Registry
docker.io
Namespace
kserve
Repository
huggingfaceserver
Cached tags
49
Last synced
07/06/2026, 03:02 AM

Introduction

KServe HuggingFace 模型推理服务器镜像,加载 HF Transformers 模型提供 REST/gRPC 预测,K8s InferenceService 标准运行时。

Details

kserve/huggingfaceserver 运行 KServe HuggingFace 推理运行时,加载 HuggingFace Hub 模型提供 REST/gRPC predict API。定位为 ML 推理 API 服务,KServe InferenceService CR 引用;K8s Deployment + GPU nodeSelector 模型 serving。

快速启动

docker run -d --name hf-server \
  -p 8080:8080 \
  -e MODEL_NAME=bert-base-uncased \
  docker.io/kserve/huggingfaceserver:latest

推荐实践

kubectl apply -f - <<EOF
apiVersion: serving.kserve.io/v1beta1
kind: InferenceService
metadata:
  name: bert
spec:
  predictor:
    model:
      modelFormat:
        name: huggingface
      storageUri: gs://models/bert
      runtime: kserve-huggingface
EOF

核心参数说明

  • 安装 — KServe + InferenceService CR
  • -e MODEL_NAME — HuggingFace 模型 ID
  • GPU — 大模型需 GPU nodeSelector
  • 存储 — PVC/S3 model storageUri

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: hf-server
spec:
  replicas: 1
  selector:
    matchLabels:
      app: hf-server
  template:
    metadata:
      labels:
        app: hf-server
    spec:
      containers:
        - name: server
          image: docker.io/kserve/huggingfaceserver:0.13.0
          ports:
            - containerPort: 8080
          env:
            - name: MODEL_NAME
              value: bert-base-uncased
---
apiVersion: v1
kind: Service
metadata:
  name: hf-server
spec:
  selector:
    app: hf-server
  ports:
    - port: 8080
      targetPort: 8080

InferenceService CR 生产推荐;GPU Resource limit 按模型调整。

Latest tags (20)

View all 49 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/kserve/huggingfaceserver
:latest
linux/amd64
2026/07/04 01:153.4 GBsha256:3174b16cf4a3
docker.io/kserve/huggingfaceserver
:latest-gpu
linux/amd64
2026/07/04 00:315.8 GBsha256:e512a784d81a
docker.io/kserve/huggingfaceserver
:v0.19.0
linux/amd64
2026/06/13 05:233.4 GBsha256:8004f7b75457
docker.io/kserve/huggingfaceserver
:v0.19.0-gpu
linux/amd64
2026/06/13 04:455.8 GBsha256:e8d2f6eba005
docker.io/kserve/huggingfaceserver
:v0.19.0-rc0
linux/amd64
2026/05/28 07:483.4 GBsha256:aa3057e2f4fb
docker.io/kserve/huggingfaceserver
:v0.19.0-rc0-gpu
linux/amd64
2026/05/28 07:055.7 GBsha256:aa709b8fa43c
docker.io/kserve/huggingfaceserver
:v0.17.1-gpu
linux/amd64
2026/05/21 23:598.9 GBsha256:d3dbddd13ef1
docker.io/kserve/huggingfaceserver
:v0.17.1
linux/amd64
2026/05/21 23:484.0 GBsha256:a28969e7b5cf
docker.io/kserve/huggingfaceserver
:v0.18.0
linux/amd64
2026/04/29 22:464.2 GBsha256:b941d5390b5c
docker.io/kserve/huggingfaceserver
:v0.18.0-gpu
linux/amd64
2026/04/29 22:149.3 GBsha256:48ec627bc33f
docker.io/kserve/huggingfaceserver
:v0.18.0-rc1
linux/amd64
2026/04/22 04:344.2 GBsha256:46a42e609dbd
docker.io/kserve/huggingfaceserver
:v0.18.0-rc1-gpu
linux/amd64
2026/04/22 04:129.3 GBsha256:c4d7c0f0ff53
docker.io/kserve/huggingfaceserver
:v0.18.0-rc0
linux/amd64
2026/04/18 23:444.2 GBsha256:5cb30ce51bd7
docker.io/kserve/huggingfaceserver
:v0.18.0-rc0-gpu
linux/amd64
2026/04/18 23:139.3 GBsha256:7aba40dce490
docker.io/kserve/huggingfaceserver
:v0.17.0-gpu
linux/amd64
2026/03/14 07:428.8 GBsha256:be6dd10254d5
docker.io/kserve/huggingfaceserver
:v0.17.0
linux/amd64
2026/03/14 07:304.0 GBsha256:7ce411308305
docker.io/kserve/huggingfaceserver
:v0.17.0-rc1-gpu
linux/amd64
2026/03/12 22:598.8 GBsha256:ebb50a9a2fca
docker.io/kserve/huggingfaceserver
:v0.17.0-rc1
linux/amd64
2026/03/12 22:464.0 GBsha256:9806c5a56343
docker.io/kserve/huggingfaceserver
:v0.17.0-rc0-gpu
linux/amd64
2026/03/07 03:268.8 GBsha256:c3180ca83192
docker.io/kserve/huggingfaceserver
:v0.17.0-rc0
linux/amd64
2026/03/07 03:144.0 GBsha256:56b6384ac936