ComfyUI-SiberiaNodes
Custom nodes for ComfyUI with Ollama integration for LLM chat, vision analysis, and utilities
Nodes (6)
An error message that tells you what broke
The Siberia Multi Image Input, and the black-image trap it hides
Siberia's Ollama Chat and the history that won't go away
The no-API-key gateway between ComfyUI and your local LLM server
Point a local vision model at your ComfyUI images — the Siberia Ollama Vision node
A tiny output node that finally lets you read your text wires
ComfyUI-SiberiaNodes User Guide 用户使用指南
Author: siberiah0h Email: [email protected] Technical Blog: www.dataeast.cn Version: 1.1.0 License: MIT
概述 / Overview
ComfyUI-SiberiaNodes 是一个专为 ComfyUI 开发的自定义节点包,提供了与 Ollama 大语言模型的集成功能,以及图像处理和数据显示工具。
ComfyUI-SiberiaNodes is a custom node package for ComfyUI that provides integration with Ollama Large Language Models, along with image processing and data display utilities.
功能特性 / Features
- 🔌 Ollama 集成: 连接本地或远程 Ollama 服务器
- 💬 聊天功能: 基于文本的对话交互
- 👁️ 视觉分析: 图像理解和分析能力
- 🖼️ 图像加载: 简单易用的图像加载节点
- 🔄 多图处理: 支持1-8张图片的同时输入和处理
- 📊 通用显示: 支持任意数据的可视化展示
安装 / Installation
1. 克隆节点包 / Clone Node Package
cd ComfyUI/custom_nodes
git clone https://github.com/siberiah2o/ComfyUI-SiberiaNodes.git
2. 安装依赖 / Install Dependencies
cd ComfyUI-SiberiaNodes
pip install -r requirements.txt
3. 启动 ComfyUI / Launch ComfyUI
# 返回 ComfyUI 主目录
cd ../../
python main.py
配置 / Configuration
Ollama 服务器配置 / Ollama Server Configuration
配置文件位于 config.yaml,支持多服务器配置:
Configuration file is located at config.yaml, supporting multiple server configurations:
last_used_server: http://127.0.0.1:11434
ollama_servers:
- name: Local Server / 本地服务器
url: http://127.0.0.1:11434
- name: Remote Server / 远程服务器
url: http://your-remote-server:31434
Ollama 安装 / Ollama Installation
本地安装 / Local Installation
# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# 启动 Ollama 服务
ollama serve
# 下载模型
ollama pull qwen3-vl:4b # 视觉分析(4B参数版本)
ollama pull qwen3-vl:8b # 视觉分析(8B参数版本)
节点详解 / Node Details
1. Siberia 图片加载器 / Siberia Image Loader
功能: 从 ComfyUI input 文件夹加载图像 Function: Load images from ComfyUI input folder
输入 / Inputs:
image: 选择要加载的图像文件
输出 / Outputs:
图片 / Image: 加载的图像张量信息 / Info: 加载状态信息
使用示例 / Usage Example:
图像文件 → Siberia Image Loader → 图像张量
2. Siberia 多图片输入器 / Siberia Multi Image Input
功能: 同时处理多张图像,支持1-8张图片的批量输入 Function: Process multiple images simultaneously, supporting batch input of 1-8 images
输入 / Inputs:
input_count: 输入图片数量 (1-8)image_1到image_8: 各个图像输入端口(动态显示)
输出 / Outputs:
图片张量列表 / Images Tensor List: 堆叠后的图像张量
使用示例 / Usage Example:
多张图片 → Siberia Multi Image Input → 图像张量列表 → Ollama Vision
特性 / Features:
- 动态输入端口:根据设定的数量显示对应数量的图像输入
- 批量处理:将多张图片堆叠成单个张量进行处理
- 灵活配置:支持1-8张图片的任意数量组合
3. Siberia Ollama 连接器 / Siberia Ollama Connector
功能: 连接到 Ollama 服务器并获取可用模型 Function: Connect to Ollama server and fetch available models
输入 / Inputs:
server: 选择 Ollama 服务器model_name: 指定要使用的模型名称
输出 / Outputs:
connector: 连接器对象,供其他 Ollama 节点使用
使用示例 / Usage Example:
Ollama Connector → 其他 Ollama 节点
4. Siberia Ollama 聊天 / Siberia Ollama Chat
功能: 与 Ollama 模型进行文本对话 Function: Have text conversations with Ollama models
输入 / Inputs:
message: 用户消息connection: Ollama 连接器(可选)clear_history: 是否清除历史记录temperature: 温度参数(0-1)max_tokens: 最大输出令牌数language: 语言选择(中文/English)
输出 / Outputs:
text: 模型回复文本response: 完整响应对象
使用示例 / Usage Example:
Connector + Prompt → Ollama Chat → 回复文本
5. Siberia Ollama 视觉分析 / Siberia Ollama Vision
功能: 使用多模态模型分析图像内容 Function: Analyze image content using multimodal models
输入 / Inputs:
connection: Ollama 连接器image: 输入图像张量prompt: 分析提示词clear_history: 是否清除历史记录temperature: 温度参数(0.1-1.0)max_tokens: 最大输出令牌数language: 语言选择(中文/English)
输出 / Outputs:
text: 分析结果文本response: 完整响应对象
使用示例 / Usage Example:
Connector + Image + Prompt → Ollama Vision → 分析文本
6. Siberia 通用显示 / Siberia Universal Display
功能: 显示任意类型的数据 Function: Display any type of data
输入 / Inputs:
data: 要显示的数据(任意类型)
输出 / Outputs:
data: 原样输出的数据
使用示例 / Usage Example:
任意数据 → Universal Display → 格式化显示
工作流示例 / Workflow Examples
示例 1: 基础图像分析 / Basic Image Analysis
Image Loader → Ollama Vision → Universal Display
↑
Connector ←
- 使用 Image Loader 加载图像
- 连接到 Ollama 服务器
- 对图像进行视觉分析
- 显示分析结果
示例 2: 文本对话工作流 / Text Chat Workflow
Connector → Ollama Chat → Universal Display
- 配置 Ollama 连接
- 输入对话提示
- 获取模型回复
- 显示结果
示例 3: 多图像批量分析 / Multi-Image Batch Analysis
Image Loader (x3) → Multi Image Input → Ollama Vision → Universal Display
↑
Connector ←
- 使用多个 Image Loader 加载不同的图像
- 通过 Multi Image Input 将图片堆叠成批次
- 对图片批次进行统一的视觉分析
- 显示批量分析结果
示例 4: 图像描述生成 / Image Description Generation
Image Loader → Ollama Vision → Ollama Chat → Universal Display
↑ ↑
Connector ←───────────────────────┘
- 加载图像并生成初步描述
- 基于描述进行进一步对话
- 生成最终文本输出
依赖要求 / Dependencies
- ComfyUI: 基础环境
- PyTorch: >= 1.13.0
- NumPy: >= 1.21.0
- Pillow: >= 8.0.0
- Requests: >= 2.25.0
- Ollama: >= 0.1.0
- Typing Extensions: >= 4.0.0
更新日志 / Changelog
v1.1.0
- 新增多图片处理功能
- 添加 Siberia Multi Image Input 节点
- 支持1-8张图片的同时输入和批量处理
- 优化图像输入的动态配置
v1.0.0
- 初始版本发布
- 支持基础的 Ollama 连接和聊天功能
- 添加图像加载和视觉分析
- 实现通用数据显示节点
贡献 / Contributing
欢迎提交 Issue 和 Pull Request 来帮助改进这个项目!
Welcome to submit Issues and Pull Requests to help improve this project!
许可证 / License
本项目采用 MIT 许可证。详见 LICENSE 文件。
This project is licensed under the MIT License. See the LICENSE file for details.
支持 / Support
如果您遇到问题或有功能建议,请:
- 提交 GitHub Issue
- 查看文档和示例
- 加入社区讨论
注意事项 / Important Notes:
- 请确保 Ollama 服务正常运行
- 建议使用 GPU 加速以获得更好性能
- 定期更新到最新版本以获得新功能和修复