[Huggingface] 如何建立自己的Space

简单介绍

Hugging Face, Inc. is a French-American company based in New York City that develops computation tools for building applications using machine learning. It is most notable for its transformers library built for natural language processing applications and its platform that allows users to share machine learning models and datasets and showcase their work.

简单来说就是一个社区，它提供了服务器的功能，用户可以把自己建立的应用，模型等通过它的服务能够在公网进行访问和使用

前提准备

• huggingface, github账号

第一步 建立新的space

在这里选择new space, 可以看到huggingface还支持建立模型，数据集等，这些目前用不到

这一步需要填写下列内容

• 你的空间名称

• 对空间的描述

• 许可，这里可默认不写

• 选择空间的SDK, 这一步很关键，决定了你的空间是何种类型的;可以看到我们可以使用Gradio构建web应用，用HTML构建静态内容，或者使用Docker拉取镜像。

  • 这里Huggingface提供了很丰富的不同版本的内容，可按照个人喜好自由选择

• 公开/私有： 决定你的空间是否别人能够访问

第二部，配置 Space

以我这里选择Gradio为例（不同类型流程也是一样的），你现在需要做的事情有：

• 克隆space到自己的Github仓库

• 创建/修改克隆到仓库中的文件内容，以符合你的需要

  • 如图，这是我的space项目，我简单修改了其中的app.py内容，使其能够通过我的Key访问大模型，实现简单的AI问答功能
  • 我这里通过 Github 的 codespace功能， 很方便就能实现对文件的修改和上传功能，而且其布局也和Vscode完全一致
  • 

• 当你完成后，需要把这些文件push到space中，完成对space内容中的更新：

  • 具体推送需要用到的指令如下：

  git add .
  
  git remote add origin-hf https://huggingface.co/spaces/wittleLuna/Test 
  
  git commit -am "app.py requirements.txt(例子，这里写你的文件名)"

  git push origin-hf main --force

• 具体解释：

git add .

意思： 把当前目录下的所有改动文件（包括新建的）添加到 Git 暂存区（staging area）。

用途： 你必须先 add，才能 commit。这一步表示“我准备提交这些文件”。

git remote add origin-hf https://huggingface.co/spaces/wittleLuna/Test

意思： 为当前 Git 仓库添加一个远程地址，名字叫 origin-hf，对应的是 Hugging Face Spaces 上你的 Space 项目的 Git 地址。

用途： 以后你可以使用这个名字 origin-hf 来 push 或 pull 到这个 Hugging Face Space。

🧠 类似于给 Git 起了个别名：origin-hf 指向 Hugging Face Space。

git commit -am "app.py requirements.txt(例子，这里写你的文件名)"

意思： 把你暂存的更改保存为一次“提交”，并附上提交信息（备注说明）：

• -a：自动将修改过的文件加入提交（不包含新文件）
• -m：后面跟的是提交信息，比如你改了哪些文件

⚠️ 注意：新建文件（没 git add 过）不会被 -a 自动提交，仍需手动 git add . 先添加。

git push origin-hf main --force

意思： 将本地的 main 分支强制推送到 Hugging Face 的远程 origin-hf 仓库（覆盖远程内容）。

• --force：如果远程仓库已有内容（比如模板代码），这会强制覆盖。

⚠️ 风险：--force 会覆盖远程仓库的历史，建议只有你明确知道要“重新上传整个 Space 项目”时才用它。

第三步 Space运行上线

当你成功上传了文件后，在你的space 页面的上方的no application file将进入运行状态，类似与服务器，你可以从旁边的log查看日志，以便排查错误。

现在只需要耐心等待space构建完毕，你自己的space项目便上线可用了！只要你设置为了Public,所有人都可以通过你的Space地址来使用。

这里是我构建的简单AI问答space,你也可以考虑实现更复杂功能的space。