huggingface2.md

hajimi

• 本项目目前分为两部分[studio轮询], [vertex模式]，两部分互相独立互不影响
• 本项目可在主流云平台“huggingface/claw”、vps、Windows本地一键端进行部署

Gemini主流白嫖平台

• AI studio（Google账号注册）
  • 目前免费：仅flash模型
  • 喜报：Google恢复了免费key的2.5pro访问权限(rpd100,rpm5,tpm250k,tpd6M)
• vertex AI（绑卡）
  • 目前免费：仅0325pro-exp（每分钟上下文131k）
• vertex AI express（快速模式，无需绑卡，点击领取，有些人能领有些人不能）
  • 只能使用：0506pro-pre，flash0520（0325pre=0506pre，0417flash=0520flash）

本项目支持

• 轮询模式：使用AI studio key
  • 除密码外，变量全部是轮询模式使用，vertex模式无效
• vertex模式：使用vertex AI，vertex AI express
  • vertex AI需要json文件，vertex AI express只需要填写key

请各位先有一个共识，现在部署位置很多，每个人用的Gemini平台与模型也不同，所以：!! 不同平台不同模型的审核、报错不同，不同部署方式出问题的情况也不同，因此相互之间比较没有任何意义！

• 问报错之前请先提供：
  • 项目在哪里？或用什么部署的
  • 你使用的Gemini平台是哪个？
  • 你使用的Gemini模型是哪个？
  • 项目前端的“系统日志”截图

huggingface部署教程（轮询部分）

• 完全部署你需要经历[在github构建镜像]→[在huggingface创建空间]→[在酒馆中连通]

0. 在github构建镜像

（⬇️⬇️⬇️以下操作全部在github网站进行）

0.1 Fork本项目

• 点击链接：[https://github.com/wyeeeee/hajimi/fork]
• 注意：现在Huggingface在封禁hajimi镜像，所以在fork仓库时不要使用hajimi原名，随便写点其他东西来填写Repository name
• 点击底部绿色按钮Create fork完成Fork操作

0.2 构建镜像

• 点击顶部的Action
• 点击绿色按钮I understand my workflows, go ahead and enable them
• 在左侧侧边栏点击GHCR CI
• 点击右侧的Run workflow按钮
• 直接点击弹出的Run workflow开始构建镜像（需要等待一些时间）
• ⚠️镜像地址为：ghcr.io/你的github用户名/你填写的仓库名:latest
  • 例如：ghcr.io/wyeeeee/hajimi:latest。
  • 记住这个镜像等下要在huggingface中填写

1. 在huggingface创建空间

（⬇️⬇️⬇️以下操作全部在huggingface网站进行）

本教程基于电脑端，手机端按钮位置可能不一样，多找找好吗？真弄不明白使用浏览器 `请求桌面网站` 改成电脑版

1.1 前置作业

• 注册huggingface：[https://huggingface.co/]

1.2 创建Spaces (空间)

• 进入huggingface创建Spaces页面：[https://huggingface.co/spaces]
• 在右上角点击+New Spaces
• 必填/必选项：
  • Owner（默认是你的用户名，别动）
  • space name（自己填写，根据网站判断会出现各种错误，比如重名、有大写，自己填一个可用的）
  • Select the Space SDK（选择“Docker”，点开后用默认的“Blank”即可，不要选别的）
  • 最后一定要选择public(公开)
  • 点击Create Space，完成空间创建

1.3 部署本项目

• 空间创建好之后点击顶部的Files
• 点击右上角Contribute，选择Create a new file
• ⚠️接下来是重点不要填错！
  • 在“Name your file”输入框填写：！！只能填写Dockerfile这几个字！！
  • 在"Edit"中粘贴以下内容

FROM ghcr.io/这里填你的github用户名/你的git仓库名:latest

EXPOSE 7860

CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]

注意：“ghcr.io/这里填你的github用户名/你的git仓库名:latest”就是之前说的你的镜像，如果github用户名有大写是不识别的，改为小写

• 全部填写完毕其他位置不用动，直接点击最底部Commit new file to main，完成部署

1.4 但还没完，配置必须项（变量）

• 点击顶端settings
• 下拉找到Variables and secrets
• 点击New secrets

!! 必须变量：

• Name填写PASSWORD | value填写你的密码 (可以不填，你不设置默认密码是123) | 点击保存
• Name填写GEMINI_API_KEYS| value填写你的key (多个key用“,”英文逗号隔开，不能换行填进value中，示例：xxx,xxx,xxx) | 点击保存
• ⛔️免责声明：key是你的个人资产，为了安全隐私，因此保存后变量中不会显示你输入过的key，！！请一定保存好！！
• 💡更多变量，点击下载txt：[https://github.com/wyeeeee/hajimi/releases/tag/settings]

1.5 项目前端

• 如果报错你要问问题（如果不知道说的是什么，请返回教程顶部看完最前面的一段字）：
  • 项目在哪里？或用什么部署的
  • 你使用的Gemini平台是哪个？
  • 你使用的Gemini模型是哪个？
  • 项目前端的“系统日志”截图（黄的红的都截哦）
• 你在很多地方都可以看见本项目的前端界面：
  • 比如点击顶端栏的App，或者从个人信息进入点击空间卡默认就是项目的前端
• 以防你看不懂或者找不到，前端链接https://huggingface.co/spaces/你的huggingface用户名/你的huggingface空间名
• 抱脸公开面板url是https://{username}-{spacename}.hf.space别搞混了，这个是填酒馆和直接在浏览器打开的url，上面的是Huggingface里的

vertex模式通用教程

（⬇️⬇️⬇️以下内容在项目前端页面操作）

• 完全部署你需要经历[已经部署了huggingface部署教程（轮询部分）（或者其他平台部署完是一样的）]→[在项目前端配置]→[在酒馆中连通]
• 点击右上角打开vertex
• 填写Vertex 配置
• 分支
  • 如果你是vertex绑卡用户：直接填写Google Credentials JSON和你的密码，点击保存（不要打开Vertex Express）
  • 如果你是vertex快速模式用户：打开Vertex Express，在Vertex Express API密钥填写你的AQ密钥和你的密码，点击保存（不要碰Google Credentials JSON你没有也不需要）
  • 如果你是天选用户，两个都有，那么开了快速就默认用的是快速key

⚠️⚠️⚠️ 每次重建空间，请删除旧的！！白嫖就轻点薅，不能排除因为账号下相同项目过多，是否会再次导致huggingface开始禁封本项目（是的，已经不是第一次了！）

项目更新

1.每次更新项目时，需要先回到github，对你Fork的项目进行更新

• 在github右上角你的头像，进入你的个人主页就可以看到你Fork过的所有项目
• 在里面找到hajimi并点击
• 点击后上方会有Sync fork按钮，点击
• 弹出界面点击绿色按钮Update branch进行更新

2.进入huggingface空间，进行更新（就是本项目的前端界面）

• 点击顶部Files，选择后面的“⁝”符号，点击Restart Space（理论上可以，不行看3）

3.另一种更新获取

• 如果上面方式无效点击Dockerfile这个文件名，进入
• 点击Edit
• 把“FROM ghcr.io/jairo-t/hajimi:latest”这句结尾的“latest”改为最新版本号，比如0.3.1
• 点击底部Commit changes to main

注意：无论用2还是3，都要先在github更新你Fork的项目

在酒馆中连通

• 选择自定义（兼容OpenAI）
• 填写链接与密钥：
  • huggingface链接：https://你的huggingface用户名-你的空间名.hf.space/v1，示例：https://tt335-hiiijimi.hf.space/v1
  • 密钥：你的设置的PASSWORD