SuperAPI AI 工具集

deploy-hf

部署与运维

查看项目

更新于 10-15 22:15

技能介绍

用途:deploy-hf 用于把 OpenEnv 环境部署到 Hugging Face Spaces,适用于用户要求“部署到 Hugging Face”“推送到 Hugging Face Spaces”或更新已有 Space 的场景,也用于新功能需要生产环境验证时。

前提条件:环境需包含 openenv.yaml 与 server/Dockerfile,并已配置 Hugging Face 凭据(通过 huggingface-cli 自动完成)。

使用方式:先确定要部署的环境目录与仓库 ID(格式 username/space-name),在项目根目录安装 OpenEnv:uv pip install -e .,然后执行:PYTHONPATH=src uv run python -m openenv.cli push <environment-dir> --repo-id <username/space-name>。可选参数包括 --private(私有 Space)、--no-interface(仅 API)、--base-image <image>(覆盖基础镜像)、--hardware <hw> 或 -H <hw>(如 t4-medium、a10g-small、cpu-basic)。

部署后需等待构建完成:CPU 环境约 5 分钟,GPU(CARLA)约 30-60 分钟;可用 curl https://<username>-<space-name>.hf.space/health 做健康检查,并可用 /reset、/step 等接口测试。

限制与排错:需先登录 huggingface-cli login;若报 ModuleNotFoundError: No module named 'openenv',说明未在项目根目录安装;若报“does not appear to be a Python project”,说明不在含 pyproject.toml 的项目根目录;环境目录路径需正确(如 envs/carla_env)。默认 Space 为公开、启用 Web 界面;GPU Space 需通过 --hardware 指定硬件。CLI 会自动把 Dockerfile 移到仓库根目录以兼容 Hugging Face。构建失败时需检查 Dockerfile、依赖、硬件设置、openenv.yaml 及 Space 日志。具体收费、价格与更多平台细节暂未提供。