Spaces:
Running
Running
| # 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` | |