zoomaker

其他资源 2025-08-15

<span class = Zoomaker _social_keyvisual“ style =”最大宽度:100%;”>

zoomaker友好的房屋为您的AI模型动物园和相关资源保留。

zoomaker是一种命令行工具,可帮助安装AI模型,GIT存储库和运行脚本。

  • 真理的单一来源:所有资源在Zoo.yaml文件中均整齐定义
  • 冻结版本:确切地知道随时安装资源的哪个修订版
  • 仅下载一次:优化带宽并在本地缓存您的模型
  • 优化磁盘用法:下载的型号已缓存

tl; dr

  1. 安装zoomaker PIP安装zoomaker
  2. 在Zoo.yaml文件中定义您的资源
  3. 运行zoomaker安装以安装它们

?安装

pip install zoomaker 

?Zoo.yaml示例

具有自动1111图像生成器的稳定扩散项目的Zoo.yaml的示例:

 name : my-automatic1111-model-zoo
version : 1.0
description : Lorem ipsum
author : your name

resources :
  image_generator :
    - name : automatic1111
      src : https://g*ith*ub.*com/AUTOMATIC1111/stable-diffusion-webui.git
      type : git
      revision : 22bcc7be428c94e9408f589966c2040187245d81
      install_to : ./

  models :
    - name : v2-1_768-ema-pruned
      src : stabilityai/stable-diffusion-2-1/v2-1_768-ema-pruned.safetensors
      type : huggingface
      install_to : ./stable-diffusion-webui/models/Stable-diffusion/
`Zoo.yaml`示例长
 name : my-automatic1111-model-zoo
version : 1.0
description : Lorem ipsum
author : your name

aliases :
  image_generator : &image_generator ./
  models : &models ./stable-diffusion-webui/models/Stable-diffusion/
  controlnet : &controlnet ./stable-diffusion-webui/models/ControlNet/
  embeddings : &embeddings ./stable-diffusion-webui/embeddings/
  extensions : &extensions ./stable-diffusion-webui/extensions/

resources :
  image_generator :
    - name : automatic1111
      src : https://g*ith*ub.*com/AUTOMATIC1111/stable-diffusion-webui.git
      type : git
      revision : 22bcc7be428c94e9408f589966c2040187245d81
      install_to : *image_generator

  models :
    - name : v1-5-pruned-emaonly
      src : runwayml/stable-diffusion-v1-5/v1-5-pruned-emaonly.safetensors
      type : huggingface
      install_to : *models

  controlnet :
    - name : control_sd15_canny
      src : lllyasviel/ControlNet/models/control_sd15_canny.pth
      type : huggingface
      install_to : *controlnet

  embeddings :
    - name : midjourney-style
      src : sd-concepts-library/midjourney-style/learned_embeds.bin
      type : huggingface
      install_to : *embeddings
      rename_to : midjourney-style.bin
    - name : moebius
      src : sd-concepts-library/moebius/learned_embeds.bin
      type : huggingface
      install_to : *embeddings
      rename_to : moebius.bin

  extensions :
    - name : sd-webui-tunnels
      src : https://git**hub.co*m/Bing-su/sd-webui-tunnels.git
      type : git
      install_to : *extensions
`zoo.yaml`带脚本片段

以下是如何从zoo.yaml文件运行脚本片段的一些示例。例如,要启动自动1111的WebUI,您可以设置这样的摘要,然后使用zoomaker Run Start_webui运行它们。所有脚本都是从项目的根源运行的,请相应地调整路径。

 scripts :
  start_webui : |
    cd .\stable-diffusion-webui && call webui.bat 
 scripts :
  start_webui : |
    conda activate automatic1111
    cd /home/$(whoami)/stable-diffusion-webui/
    ./webui.sh --xformers --no-half
`zoo.yaml`与Web下载
 resources :
  models :
    - name : analog-diffusion-v1
      src : https://civita*i.c*o*m/api/download/models/1344
      type : download
      install_to : ./stable-diffusion-webui/models/Stable-diffusion/
      rename_to : analog-diffusion-v1.safetensors

请注意:资源类型:下载可以看作是最后的度假胜地。现有的网络下载是跳过的,但没有其他缓存。建议避免网络下载:)

?动物园结构

顶级:
  • 名称(强制性)
  • 版本,描述,作者,别名(可选)
  • 资源(强制性):<group-name>:[](资源数组)
  • 脚本(可选):<脚本名称>
资源:
  • 名称,src,type,install_to(强制性)
  • Rename_to(可选)
  • 修订(可选),如果没有定义,则下载了主分支的最新版本
  • 类型可以是git,huggingface或下载
  • api_key(可选)civitai

zoomaker命令

所有命令均从项目的根部运行,您的Zoo.yaml文件位于其中。

命令 行动
zoomaker安装 安装Zoo.yaml中定义的资源
zoomaker运行<script_name> 运行Zoo.yaml中定义的CLI脚本
zoomaker -Help 使用zoomaker CLI获得帮助
zoomaker version 显示当前的zoomaker版本
zoomaker安装-F <File> 安装指定YAML文件中定义的资源
zoomaker运行-F <File> <script_name> 运行指定YAML文件中定义的CLI脚本

?拥抱面部访问令牌和自定义缓存位置

在zoomaker安装过程中,可能会要求您提供拥抱的脸部访问令牌。拥抱面孔的一些资源需要接受模型的使用条款。您可以通过在终端中运行此命令来设置访问令牌。命令huggingface-CLI自动与zoomaker一起运送。

huggingface-cli login

您可以通过设置HF_HOME环境变量来指定自定义缓存位置。默认缓存位置为〜/.cache/huggingface/。

 export HF_HOME=/path/to/your/cache
zoomaker install

致谢

  • 大多数内部繁重的举重都是通过拥抱脸的huggingface_hub图书馆完成的。谢谢!
  • 基于此OpenMoji,Alia Tasler的“ zoomaker Safari Hacker Cat”封面图片。谢谢!
下载源码

通过命令行克隆项目:

git clone https://github.com/hfg-gmuend/zoomaker.git