text-generation-webui 模型下载完整教程一条命令拿回大模型【免费下载链接】textgenOpen-source desktop app for local LLMs. Text, vision, tool-calling, OpenAI/Anthropic-compatible API. 100% private.项目地址: https://gitcode.com/GitHub_Trending/te/textgentext-generation-webui 的模型下载功能由内置脚本download-model.py提供给它一个 HuggingFace 模型名它替你完成挑文件、下文件、放文件、验文件整套流程是 HuggingFace 大模型下载最省事的本地入口。一键下载模型一条命令先跑通你的目标很简单模型文件落到本地user_data/models打开界面就能直接选用。命令只有一条python download-model.py facebook/opt-1.3b它比手动下载省三件事不用打开仓库页面逐个判断该下哪几个文件断网后重跑会自动从断点续传文件放哪个目录不用你操心路径它自己规划。这条命令背后模型下载如何自动识别格式与过滤文件同样是下模型手动操作和download-model.py的差别环节手动下载download-model.py格式识别自己判断该下哪种格式按扩展名自动识别Safetensors 与其他格式共存时只下前者文件过滤容易漏下词表、误下无关文件只取权重、配置、词表GGUF 仓库自动挑 Q4_K_M 量化版存储路径目录结构自己记按组织名_模型名自动建子目录归位完整性无法确认文件好坏--check逐个比对 sha256中断恢复删了重下保留进度重跑即续传HuggingFace 模型下载的 3 种模型名写法标准路径组织名/模型名最常用facebook/opt-1.3b带分支同一模型挂多个量化版本时冒号后写分支名TheBloke/Llama-2-13B-chat-GPTQ:gptq-4bit-128g完整 URL手里是某个文件的直链粘入带/resolve/的文件地址工具只下这一个文件适合单独补下一个 GGUF。LLM 怎么下载先小模型跑通再上大模型 先用最小的 gpt2 试跑确认整条链路没问题python download-model.py gpt2✅ 再校验完整性。--check会逐个比对下载时记录的 sha256 校验和全部通过会有明确提示校验失败就加--clean重新下载。python download-model.py gpt2 --check大文件下载最快加速方法--threads让多个文件同时下载默认 4 个python download-model.py bigscience/bloom-7b1 --threads 8系统盘放不下用--model-dir换盘存放python download-model.py bigscience/bloom-7b1 --model-dir /data/models另外两个省空间的参数--text-only只下配置、词表等文本文件--exclude-pattern用正则排除指定文件。三种场景三种模型下载选法GGUF 是把权重压成单文件的量化格式省内存好上手Safetensors 是更安全、加载快的官方权重格式。场景推荐格式命令快速体验GGUF 模型下载首选 Q4_K_M工具自动挑python download-model.py TheBloke/Llama-2-7B-Chat-GGUF开发调试Safetensors自动优先于 PyTorchpython download-model.py facebook/opt-1.3b生产部署Safetensors 下载后校验下完执行python download-model.py 模型名 --check模型下载常见坑一页速查⚠️ 症状对上了直接抄解法症状原因解法报 401 / 403模型私有或未登录设置HF_TOKEN环境变量如export HF_TOKEN你的Token或执行huggingface-cli login下载反复中断网络不稳、传输超时--max-retries 15提高重试上限默认 7 次磁盘空间不足默认存在 user_data 所在盘用--model-dir /data/models指向其他盘下载的文件都去哪了models 与 loras 目录规则普通多文件模型user_data/models/下按组织名_模型名建子目录非 main 分支会追加分支名LoRA 微调模型检测到 adapter 文件后自动归入user_data/loras单个 GGUF 文件URL 直链方式直接平铺在user_data/models里。每个模型目录还会生成huggingface-metadata.txt记录下载时间和 sha256 清单--check就是拿它来比对。动手下载第一个模型先用 gpt2 把上面四步跑一遍链路通了再换你真正想用的模型。遇到问题先翻官方文档 docs/还解决不了就带着完整报错到项目社区提问。【免费下载链接】textgenOpen-source desktop app for local LLMs. Text, vision, tool-calling, OpenAI/Anthropic-compatible API. 100% private.项目地址: https://gitcode.com/GitHub_Trending/te/textgen创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考