🔥 主要改进: - 🎨 采用readme-prompt规范,提升视觉美观度和可读性 - 🌈 优化徽章系统,增加更多状态指标(Stars、Forks、Issues、License、Last Commit) - 📱 增强语言切换按钮设计,使用大号徽章样式 - 🏗️ 重新设计页面结构布局,增加分隔线和留白 - 📊 完善模型对比表格,增加价格等级和核心优势说明 - 🔧 新增技术亮点展示,突出项目特色 - 📚 简化文档结构,突出核心功能和快速上手 - ❓ 改进FAQ部分,使用可折叠详情设计 - 👥 优化联系方式和社区链接 - 🐳 完善Docker部署说明和配置示例 💡 设计原则: - 信息清晰度优先,减少认知负担 - 视觉美观符合极客审美 - 易于导航和维护 - 跨平台兼容性良好 🌐 中英文同步优化,保持一致的专业水准
🚀 ComfyUI-LLMs-Toolkit
📖 项目简介
ComfyUI-LLMs-Toolkit 是一个高性能的ComfyUI扩展,专为AI创作者设计。通过轻量级API驱动方案,即使在有限计算资源下也能轻松接入DeepSeek、通义千问、GPT等世界级大语言模型,让AI创作民主化。
🎯 为什么选择我们?
- 🚀 零硬件门槛:无需高端GPU,仅需API即可享受前沿AI能力
- 🌍 全球模型支持:集成中外主流LLM,一站式解决方案
- ⚡ 高性能架构:优化的并发处理,大幅提升工作流效率
- 🛠️ 极客友好:环境变量配置,Docker支持,开发者至上
✨ 核心特性
🧠 强大的LLM生态系统
| 类别 | 支持模型 | 特色能力 |
|---|---|---|
| 🇨🇳 中国领军 | DeepSeek-V3, Qwen-Max, GLM-4 | 中文理解、代码生成、数学推理 |
| 🇺🇸 国际巨头 | GPT-4, Claude-3, Gemini | 多模态处理、创意写作、复杂推理 |
| ⚡ 专业垂直 | Doubao, Spark, Moonshot | 对话生成、长文本、角色扮演 |
🔧 技术亮点
- ✨ 闪电部署:一键安装,五分钟上手
- ⚡ 并发优化:多线程处理,支持批量请求
- 🛡️ 安全为先:环境变量配置,密钥安全管理
- 🔄 热重载:动态配置更新,无需重启ComfyUI
- 📊 智能缓存:响应缓存机制,降低API调用成本
- 🐳 容器化:Docker支持,一致性部署环境
🚀 快速开始
📋 系统要求
- Python: `>= 3.8`
- ComfyUI: 最新版本
- 内存: `>= 4GB RAM`
- 网络: 稳定的互联网连接
⚡ 闪电安装
```bash
🎯 方式一:Git克隆(推荐)
cd ComfyUI/custom_nodes/ git clone https://github.com/HuangYuChuh/ComfyUI-LLMs-Toolkit.git cd ComfyUI-LLMs-Toolkit
📦 安装依赖
pip install -r requirements.txt ```
```bash
🐳 方式二:Docker部署
docker pull your-dockerhub/comfyui-llms-toolkit:latest docker run -d --name comfyui-llms -p 8188:8188 your-dockerhub/comfyui-llms-toolkit ```
⚙️ 环境配置
1️⃣ 创建配置文件
```bash
复制环境变量模板
cp config/env.example .env ```
2️⃣ 配置API密钥
编辑 `.env` 文件,选择您要使用的模型:
```bash
🔥 DeepSeek(推荐新手)
DEEPSEEK_API_KEY=sk-your_deepseek_key_here DEEPSEEK_BASE_URL=https://api.deepseek.com DEEPSEEK_MODEL_NAME=deepseek-chat
🌟 通义千问(中文优化)
QWEN_API_KEY=your_qwen_key_here QWEN_BASE_URL=https://dashscope.aliyuncs.com/api/v1 QWEN_MODEL_NAME=qwen-max
🤖 OpenAI GPT(国际标准)
OPENAI_API_KEY=sk-your_openai_key_here OPENAI_BASE_URL=https://api.openai.com/v1 OPENAI_MODEL_NAME=gpt-4o-mini
🚀 更多配置参见 config/env.example
```
3️⃣ API密钥获取指南
| 🏢 提供商 | 🔗 获取地址 | 💰 免费额度 | ⭐ 推荐指数 |
|---|---|---|---|
| DeepSeek | platform.deepseek.com | ¥500免费额度 | ⭐⭐⭐⭐⭐ |
| 通义千问 | dashscope.aliyun.com | 每月100万tokens | ⭐⭐⭐⭐ |
| OpenAI | platform.openai.com | $5体验额度 | ⭐⭐⭐⭐⭐ |
| 智谱清言 | open.bigmodel.cn | 每月500万tokens | ⭐⭐⭐⭐ |
🎯 第一次运行
-
🔄 重启ComfyUI: ```bash
重启ComfyUI以加载新节点
cd /path/to/ComfyUI python main.py ```
-
🔍 查找节点:
- 在ComfyUI界面中右键
- 导航至 `Add Node` → `LLMs Toolkit`
- 选择您需要的节点类型
-
⚡ 开始创作:
- 拖入LLM节点
- 配置模型参数
- 连接输入输出
- 享受AI创作之旅!
🌟 支持的模型矩阵
🇨🇳 中国AI军团
| 模型 | 提供商 | 核心优势 | 价格等级 | 配置前缀 |
|---|---|---|---|---|
| DeepSeek-V3 | DeepSeek | 🧮 数学推理、💻 代码生成 | 💚 超低价 | `DEEPSEEK_` |
| Qwen-Max | 阿里巴巴 | 🌏 多模态、🇨🇳 中文优化 | 💛 中等 | `QWEN_` |
| GLM-4 | 智谱AI | 🤔 逻辑推理、📚 知识问答 | 💚 低价 | `GLM_` |
| Doubao-Pro | 字节跳动 | 💬 对话生成、✍️ 创意写作 | 💛 中等 | `DOUBAO_` |
| Spark-Max | 科大讯飞 | 🗣️ 语言理解、📊 文本分析 | 💚 低价 | `SPARK_` |
| Moonshot-V1 | 月之暗面 | 📖 长文本、🧠 深度理解 | 💛 中等 | `MOONSHOT_` |
🌍 国际AI豪门
| 模型 | 提供商 | 核心优势 | 价格等级 | 配置前缀 |
|---|---|---|---|---|
| GPT-4o | OpenAI | 🧠 通用智能、🎨 多模态 | 🧡 高价 | `OPENAI_` |
| Claude-3.5 | Anthropic | 🛡️ 安全对话、📚 长文本 | 🧡 高价 | `CLAUDE_` |
| Gemini-Pro | 🔍 搜索增强、🌐 多语言 | 💛 中等 | `GEMINI_` |
❓ 常见问题
🔑 Q: 如何获取API密钥?
A: 各大厂商都提供免费试用额度:
- DeepSeek: 注册即送¥500额度,适合新手试用
- 通义千问: 阿里云账号认证后可获得大额度
- OpenAI: 新用户有$5免费额度,需要国外支付方式
🖥️ Q: 支持本地模型吗?
A: 目前主要支持API调用,本地模型支持已在开发路线图中:
- v2.0: 计划支持Ollama本地模型
- v2.1: 支持GGUF格式模型
- v3.0: 支持自定义模型微调
❌ Q: 遇到连接错误怎么办?
A: 常见解决方案:
- 检查网络:确保能访问对应API服务
- 验证密钥:确认API密钥正确且有余额
- 检查配置:确认BASE_URL格式正确
- 查看日志:检查ComfyUI控制台输出
📄 开源协议
本项目采用 GNU General Public License v2.0 开源协议。
这意味着:
- ✅ 自由使用:个人和商业使用均可
- ✅ 自由修改:可以修改源代码
- ✅ 自由分发:可以分发原版或修改版
- ⚠️ 开源义务:修改版必须开源