CoolFace
Apppublic

DanielleNguyen/WindsurfAPI

sourceHugging Faceupdated 5mo agoView on Hugging Face
0likes
App README

WindsurfAPI on Hugging Face Spaces

这个 Space 运行的是 WindsurfAPI 的 Docker 版本。

运行说明

  1. 1.镜像构建时会下载官方 Linux x64 tar.gz 安装包，并自动提取 language_server_linux_x64
  2. 2.运行时从 Hugging Face Space Secrets / Variables 生成 .env
  3. 3.持久化文件保存在挂载桶的 /data/windsurf/state/
  4. 4.外部服务端口固定为 7860

HF Space 最终填写清单

名称位置是否必填说明
API_KEYSecret必填对外 API 的访问密钥
CODEIUM_API_KEYSecret可选预置Windsurf / Codeium API Key；不填也可启动
CODEIUM_AUTH_TOKENSecret可选预置windsurf.com/show-auth-token 获取的 token；不填也可启动
DEFAULT_MODELVariable 或 Secret推荐默认模型，不填走 claude-4.5-sonnet-thinking
MAX_TOKENSVariable 或 Secret推荐默认最大输出 token，不填走 8192
LOG_LEVELVariable 或 Secret推荐日志级别，不填走 info
DASHBOARD_PASSWORDSecret推荐Dashboard 访问密码
LS_PORTVariable 或 Secret可选LS gRPC 端口，不填走 42100
CODEIUM_API_URLVariable 或 Secret可选上游接口地址，不填走官方默认值

如果没有预先填写 CODEIUM_API_KEY 或 CODEIUM_AUTH_TOKEN，服务仍然可以启动，之后可以通过以下方式添加账号：

  1. 1.Dashboard 一键登录
  2. 2.Token 登录
  3. 3.批量导入

不要在 HF Space 里填写这些

  • —PORT：启动时会强制写成 7860
  • —LS_BINARY_PATH：启动时会强制写成 /opt/windsurf/language_server_linux_x64
  • —HF_TOKEN：这是 GitHub Actions 推送 Space 仓库用的，不是运行时变量
  • —HF_SPACE_REPO：这是 GitHub Actions 发布目标，不是运行时变量
  • —HF_LS_DOWNLOAD_URL：这是 GitHub Actions 构建发布包时替换 Dockerfile 用的，值应为官方 Linux x64 tar.gz 下载链接，不是运行时变量

持久化文件

  • —/data/windsurf/state/.env
  • —/data/windsurf/state/accounts.json
  • —/data/windsurf/state/proxy.json
  • —/data/windsurf/state/model-access.json
  • —/data/windsurf/state/runtime-config.json

部署来源

这个 Space 仓库由 GitHub Actions 从主仓库的 huggingface/ 发布目录自动同步生成。