> ## Documentation Index
> Fetch the complete documentation index at: https://starforge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 集成

> 关联 Hugging Face 账号，让作业能读受限模型、能推送导出结果。

## Hugging Face

关联账号解决两件作业本来做不到的事：读取受限或私有模型，以及把导出结果推回 Hub。

<Steps>
  <Step title="关联">
    通过 Hugging Face OAuth 授权。token 用部署的 `FORGE_SECRET_ENC_KEY` 加密存储。
  </Step>

  <Step title="提交一个需要它的作业">
    预检会确认配置里写的模型可达、且你有权限——在作业入队之前，
    而不是等它排完队、开始下载之后。
  </Step>

  <Step title="推送导出结果">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
    sf export my-grpo --checkpoint checkpoints/step_500 \
      --checkpoint-format nemo-dcp --push-repo alice/qwen-support-v3
    ```
  </Step>
</Steps>

<Warning>
  写权限默认关闭（`FORGE_HF_OAUTH_WRITE_ENABLED`）。安全的默认值是「什么都不会被上传」；
  `--push-repo` 能用之前，需要管理员为这套部署显式开启。
</Warning>

## 在离线内网里

没有 Hugging Face 可以关联，也不需要。内网镜像由管理员用 `FORGE_HF_ENDPOINT`
在部署级配置，所有作业直接使用，不需要任何人关联任何东西。
见[离线内网部署](/zh-Hans/ops/airgapped)。