下载和管理 Stable Diffusion 模型，可以使用命令行，也可以使用网页界面。
- **模型下载：** 浏览 Civitai、OpenModelDB 和 GitHub Releases，下载支持断点续传、SHA256
校验、预览图和元数据附属文件。
- **抱脸 / 魔搭：** 从 Hugging Face（或 hf-mirror 等镜像站）和 ModelScope 下载单个文件或整个仓库。
- **链接下载：** 粘贴任意下载地址并选择保存的文件夹，可选填文件名和用于校验的 SHA256。
- **本地模型：** 把 Hanakura 指向 ComfyUI 或 Stable Diffusion WebUI 的模型文件夹。它根据
safetensors 文件头识别每个模型的类型和基础模型（从不反序列化 pickle），显示预览图，并在导入、
移动、重命名和删除模型时一并处理预览图和附属文件。把文件拖进浏览器即可上传。
设计、约定和已知缺陷见 [AGENTS.md](AGENTS.md)。
## 安装
从 PyPI 安装：
```bash
python -m pip install hanakura
hanakura --help
```
需要 Python 3.10 或更新版本。网页界面已打包在安装包内，用户不需要 Node。
支持 Pydantic v1 和 v2。如需在已有环境中保留 Pydantic v1，请使用 Python 3.10–3.13 和兼容的
FastAPI：
```bash
python -m pip install hanakura "pydantic<2" "fastapi<0.126"
```
Python 3.14 及更新版本需要 Pydantic v2。开发检查和仓库中提交的网页 API 类型均使用 Pydantic v2
生成；CI 还会单独测试 Pydantic v1。
## 命令行
```text
hanakura
├── webui 启动服务器并打开网页界面
├── version | env
├── config show | get | set | path
├── source list
├── auth status | use 
