From d185a18d01a6bdccc58eac0fb8ca0508285bb621 Mon Sep 17 00:00:00 2001
From: claptrap0 <220574675+claptrap0@users.noreply.github.com>
Date: Sun, 13 Jul 2025 12:05:38 +0200
Subject: [PATCH] Initial commit
---
.gitattributes | 2 +
.gitignore | 181 +++++++++++++++++++
LICENSE | 21 +++
LLM_Hub.py | 446 +++++++++++++++++++++++++++++++++++++++++++++++
README.md | 103 +++++++++++
__init__.py | 1 +
img/usage.png | Bin 0 -> 130885 bytes
requirements.txt | 5 +
web/js/output.js | 26 +++
web/js/utils.js | 8 +
10 files changed, 793 insertions(+)
create mode 100644 .gitattributes
create mode 100644 .gitignore
create mode 100644 LICENSE
create mode 100644 LLM_Hub.py
create mode 100644 README.md
create mode 100644 __init__.py
create mode 100644 img/usage.png
create mode 100644 requirements.txt
create mode 100644 web/js/output.js
create mode 100644 web/js/utils.js
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..dfe0770
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..dd15ec4
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,181 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+# Usually these files are written by a python script from a template
+# before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+# For a library or package, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+# However, in case of collaboration, if having platform-specific dependencies or dependencies
+# having no cross-platform support, pipenv may install dependencies that don't work, or not
+# install all needed dependencies.
+#Pipfile.lock
+
+# UV
+# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+# This is especially recommended for binary packages to ensure reproducibility, and is more
+# commonly ignored for libraries.
+#uv.lock
+
+# poetry
+# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+# This is especially recommended for binary packages to ensure reproducibility, and is more
+# commonly ignored for libraries.
+# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+# in version control.
+# https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+# and can be added to the global gitignore or merged into this file. For a more nuclear
+# option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+# Cursor is an AI-powered code editor.`.cursorignore` specifies files/directories to
+# exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+# refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
\ No newline at end of file
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..a1bc6a2
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 claptrap0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/LLM_Hub.py b/LLM_Hub.py
new file mode 100644
index 0000000..b553f91
--- /dev/null
+++ b/LLM_Hub.py
@@ -0,0 +1,446 @@
+import os
+import torch
+import random
+import importlib
+import folder_paths
+
+from transformers import AutoModelForCausalLM, AutoTokenizer, AutoConfig, BitsAndBytesConfig, StoppingCriteria, StoppingCriteriaList, set_seed
+
+GLOBAL_MODELS_DIR = os.path.join(folder_paths.models_dir, "text_encoders", "LLMs")
+
+WEB_DIRECTORY = "./web/js"
+
+try:
+ Llama = importlib.import_module("llama_cpp_cuda").Llama
+except ImportError:
+ Llama = importlib.import_module("llama_cpp").Llama
+
+
+try:
+ from transformers import pipeline, AutoModelForCausalLM, AutoTokenizer
+except ImportError:
+ print("Transformers library not found. Please install it to use safetensors models: pip install transformers torch sentencepiece")
+ AutoModelForCausalLM = None
+ AutoTokenizer = None
+ pipeline = None
+
+
+_loaded_model = None
+_loaded_tokenizer = None
+_current_model_id = None
+_model_is_on_gpu = False
+
+def free_gpu_memory():
+ global _loaded_model, _loaded_tokenizer, _current_model_id, _model_is_on_gpu
+ if _loaded_model is not None:
+ del _loaded_model
+ _loaded_model = None
+ if _loaded_tokenizer is not None:
+ del _loaded_tokenizer
+ _loaded_tokenizer = None
+ _current_model_id = None
+ _model_is_on_gpu = False
+ if torch.cuda.is_available():
+ torch.cuda.empty_cache()
+ print("GPU memory freed.")
+
+
+class AnyType(str):
+
+ def __ne__(self, __value: object) -> bool:
+ return False
+
+
+anytype = AnyType("*")
+
+
+class LLM_Hub:
+ @classmethod
+ def INPUT_TYPES(cls):
+ model_options = []
+ if os.path.isdir(GLOBAL_MODELS_DIR):
+ listed_items = set()
+ for root, dirs, files in os.walk(GLOBAL_MODELS_DIR):
+
+ for file in files:
+ if file.endswith('.gguf'):
+ relative_path_to_file = os.path.relpath(os.path.join(root, file), GLOBAL_MODELS_DIR)
+ if os.path.dirname(relative_path_to_file) == ".":
+ display_name = os.path.splitext(relative_file_path)[0]
+ else:
+ clean_name = os.path.relpath(root, GLOBAL_MODELS_DIR)
+ if clean_name not in listed_items:
+ model_options.append(clean_name)
+ listed_items.add(clean_name)
+
+ if root == GLOBAL_MODELS_DIR:
+ for d in dirs:
+ current_dir_path = os.path.join(root, d)
+
+ if any(f.endswith(('.json', '.safetensors', '.bin')) for f in os.listdir(current_dir_path)):
+ clean_name = os.path.relpath(current_dir_path, GLOBAL_MODELS_DIR)
+ if clean_name not in listed_items:
+ model_options.append(clean_name)
+ listed_items.add(clean_name)
+
+ if not model_options:
+ model_options = ["No models found in text_encoders/LLMs/"]
+
+ return {
+ "required": {
+ "text": ("STRING", {"multiline": True, "dynamicPrompts": True, "default": ""}),
+ "seed": ("INT", {"default": 1234567890, "min": 0, "max": 0xffffffffffffffff}),
+ "model": (model_options, {"tooltip": "Select an LLM. Store your models in text_encoders/LLMs/model_name for clarity."}),
+ "max_tokens": ("INT", {"default": 512, "min": 1, "max": 8192, "tooltip": "The maximum number of tokens to generate. Higher values mean longer responses while also increasing generation time and VRAM usage."}),
+ "context_window": ("INT", {"default": 2048, "min": 256, "max": 8192, "step": 128, "tooltip": "The total context window size (input + generated response). Lower values reduce VRAM."}),
+ "apply_system_prompt": ("BOOLEAN", {"default": False, "tooltip": "When enabled your system prompt in 'system_prompt' will be used. When disabled there is a basic fallback system prompt."}),
+ "load_in_8bit": ("BOOLEAN", {"default": False, "label_on": "8bit", "label_off": "Full Precision", "tooltip": "When enabled to (8bit), HuggingFace models will load in 8-bit to reduce VRAM usage. GGUF models are not affected, as they have their own quantization."}),
+ "stay_on_gpu": ("BOOLEAN", {"default": False, "tooltip": "If enabled, the model will remain on the GPU until you restart ComfyUI or you disable this option. If disabled, the model will offload from the GPU after each run."}),
+ "system_prompt": ("STRING", {"multiline": True, "default": "You are a prompt engineer for a text-to-image AI system based on \"{prompt}\" (caption only, no instructions like \"create an image\")."}),
+ },
+ "optional": {
+ "settings": ("SETTINGS_FOR_LLM", {"tooltip": "Control settings for the LLM."}),
+ }
+ }
+
+ CATEGORY = "LLM_Hub"
+ FUNCTION = "main"
+ RETURN_TYPES = ("STRING", "STRING",)
+ RETURN_NAMES = ("generated", "original",)
+
+
+ def main(self, text, seed, model, max_tokens, context_window, apply_system_prompt, load_in_8bit, stay_on_gpu, system_prompt, settings=None):
+ model_full_path = os.path.join(GLOBAL_MODELS_DIR, model)
+ if os.path.exists(model_full_path + ".gguf"):
+ model_full_path += ".gguf"
+ elif os.path.exists(model_full_path + ".safetensors"):
+ model_full_path += ".safetensors"
+
+
+ generate_kwargs = {
+ 'max_tokens': max_tokens,
+ 'temperature': 0.8,
+ 'top_p': 0.8,
+ 'top_k': 10,
+ 'repeat_penalty': 1.3,
+ "stop": ["\n\n", "\n<|", "###", "<|im_end|>", "<|endoftext|>", "<|language_code|>en-US=eng", "Here is the caption:",]
+ }
+
+ if settings:
+ for option in ['temperature', 'top_p', 'top_k', 'repeat_penalty']:
+ if option in settings:
+ generate_kwargs[option] = settings[option]
+
+
+ if apply_system_prompt:
+ messages_for_llm = [
+ {"role": "system", "content": system_prompt},
+ {"role": "user", "content": f"Description : {text}"},
+ ]
+ else:
+ messages_for_llm = [
+ {"role": "system", "content": f"You are a prompt engineer for a text-to-image AI system (caption only, no instructions like \"create an image\"). Do not include any meta-commentary or length indicators (e.g., 'approximately X words/characters'). Your output must be a single, detailed, yet concise caption, **aiming for approximately 400 to 500 characters in total**. Prioritize rich visual descriptions. Respond EXCLUSIVELY in English. Your task is to create detailed, visually descriptive captions based on user descriptions. Your output must be only the caption itself, no instructions or extra formatting. Give detailed visual descriptions of characters (ethnicity, skin tone, expression, hair and eye color etc.). Imagine using keywords for someone with aphantasia. Describe the image style, photographic or art techniques utilized. Fully describe all aspects of the cinematography, with abundant technical details and visual descriptions. Incorporate a specific visual style. Describe the lighting setup in detail (type, color, placement). Always frame the scene, including details about color grading, camera placement."},
+ {"role": "user", "content": f"Description : {text}"},
+ ]
+
+ global _loaded_model, _loaded_tokenizer, _current_model_id, _model_is_on_gpu
+ actual_model_path = None
+ model_type = None
+ potential_path = os.path.join(GLOBAL_MODELS_DIR, model)
+
+
+ if os.path.isfile(potential_path + '.gguf'):
+ actual_model_path = potential_path + '.gguf'
+ model_type = 'gguf'
+ elif os.path.isdir(potential_path):
+ gguf_files_in_dir = [f for f in os.listdir(potential_path) if f.endswith('.gguf')]
+ if gguf_files_in_dir:
+ actual_model_path = os.path.join(potential_path, gguf_files_in_dir[0])
+ model_type = 'gguf'
+ elif any(f.endswith(('.safetensors', '.bin', '.json')) for f in os.listdir(potential_path)):
+ actual_model_path = potential_path
+ model_type = 'hf_dir'
+
+ if not actual_model_path or not model_type:
+ return (f"Error: {model} not found or unsupported format. Please check the model file name and directory structure under {GLOBAL_MODELS_DIR}.", text)
+
+
+ current_model_key = f"{actual_model_path}_offload:{stay_on_gpu}"
+
+ should_reload = False
+ if _loaded_model is None or _current_model_id != current_model_key:
+ should_reload = True
+ if _loaded_model is not None:
+ print("Model or GPU setting changed, freeing existing model.")
+ free_gpu_memory()
+ elif _model_is_on_gpu and stay_on_gpu:
+
+ pass
+ elif not _model_is_on_gpu and not stay_on_gpu:
+
+ pass
+
+
+ if not _loaded_model or _current_model_id != current_model_key:
+ print(f"Loading {model}...")
+
+ try:
+ if model_type == 'gguf':
+ if not Llama:
+ return ("Error: llama_cpp or llama_cpp_cuda not imported. Cannot load GGUF model.", text)
+
+ n_gpu_layers_val = 0
+ if torch.cuda.is_available():
+ n_gpu_layers_val = -1
+ else:
+ print("⚠️ Warning: No GPU available. GGUF model will run on CPU.")
+
+ model_to_use = Llama(
+ model_path=actual_model_path,
+ n_gpu_layers=n_gpu_layers_val,
+ seed=int(seed % (2**32 - 1)),
+ verbose=False,
+ n_ctx=context_window,
+ )
+ _loaded_model = model_to_use
+ _model_is_on_gpu = (n_gpu_layers_val != 0)
+ _current_model_id = current_model_key
+
+ elif model_type == 'hf_dir':
+ if not (AutoModelForCausalLM and AutoTokenizer and pipeline):
+ return ("Error: Transformers library not found. Cannot load safetensors model. Please install it: pip install transformers torch sentencepiece", text)
+
+ hf_model_dir = actual_model_path
+ tokenizer = AutoTokenizer.from_pretrained(hf_model_dir)
+ device_map_setting = "auto" if torch.cuda.is_available() else "cpu"
+
+ if torch.cuda.is_available() and load_in_8bit:
+ quantization_status = "8bit"
+ print(f"Loading {model} on GPU with {quantization_status}")
+ quant_config = BitsAndBytesConfig(load_in_8bit=True)
+ model_hf = AutoModelForCausalLM.from_pretrained(
+ hf_model_dir,
+ torch_dtype="auto",
+ device_map=device_map_setting,
+ quantization_config=quant_config
+ )
+ _model_is_on_gpu = True
+ elif torch.cuda.is_available() and not load_in_8bit:
+ model_hf = AutoModelForCausalLM.from_pretrained(
+ hf_model_dir,
+ torch_dtype="auto",
+ device_map=device_map_setting
+ )
+ _model_is_on_gpu = True
+ actual_dtype_str = str(model_hf.dtype).replace('torch.', '')
+ print(f"Loading {model} on GPU in {actual_dtype_str} precision")
+ else:
+ print(f"Loading {model} on CPU (no GPU available)")
+ model_hf = AutoModelForCausalLM.from_pretrained(hf_model_dir, torch_dtype=torch.float32, device_map="cpu")
+ _model_is_on_gpu = False
+
+ _loaded_model = model_hf
+ _loaded_tokenizer = tokenizer
+ _current_model_id = current_model_key
+
+ device_str = "GPU" if _model_is_on_gpu else "CPU"
+ precision_display_part = ""
+
+ if model_type == 'hf_dir':
+ if _model_is_on_gpu:
+ if load_in_8bit:
+ precision_display_part = "8bit"
+ else:
+ precision_display_part = str(model_hf.dtype).replace('torch.', '')
+ else:
+ precision_display_part = str(model_hf.dtype).replace('torch.', '')
+
+ if precision_display_part:
+ print("\n---------------------------------")
+ print(f"Loaded successfully on {device_str} in {precision_display_part}")
+ print("\n---------------------------------")
+ else:
+ print("\n---------------------------------")
+ print(f"Loaded successfully on {device_str}")
+ print("\n---------------------------------")
+ else:
+ print("\n---------------------------------")
+ print(f"Loaded successfully on {device_str}")
+ print("\n---------------------------------")
+
+
+ except Exception as e:
+ free_gpu_memory()
+ return (f"Error loading {model} from {actual_model_path}: {e}", text)
+
+
+ llm_result_content = ""
+ try:
+ capped_seed = seed % (2**32 - 1)
+ set_seed(capped_seed)
+
+ if model_type == 'gguf':
+ llm_result = _loaded_model.create_chat_completion(messages_for_llm, **generate_kwargs)
+ llm_result_content = llm_result['choices'][0]['message']['content'].strip()
+
+ elif model_type == 'hf_dir':
+
+ if _model_is_on_gpu:
+ generator = pipeline(
+ "text-generation",
+ model=_loaded_model,
+ tokenizer=_loaded_tokenizer,
+ )
+ else:
+ generator = pipeline(
+ "text-generation",
+ model=_loaded_model,
+ tokenizer=_loaded_tokenizer,
+ )
+
+
+ if hasattr(_loaded_tokenizer, 'apply_chat_template') and _loaded_tokenizer.chat_template:
+ chat_prompt = _loaded_tokenizer.apply_chat_template(messages_for_llm, tokenize=False, add_generation_prompt=True)
+
+ else:
+ chat_prompt = ""
+ for message in messages_for_llm:
+ if message["role"] == "system":
+ chat_prompt += f"<|system|>{message['content']}\n"
+ elif message["role"] == "user":
+ chat_prompt += f"<|user|>{message['content']}\n"
+ elif message["role"] == "assistant":
+ chat_prompt += f"<|assistant|>{message['content']}\n"
+ chat_prompt += "<|assistant|>"
+
+
+ stop_list = generate_kwargs.get('stop', [])
+ if stop_list:
+ class StopGenerationCriteria(StoppingCriteria):
+ def __init__(self, stops=[], encounters=1):
+ super().__init__()
+ global _loaded_tokenizer
+ self.stops = [torch.tensor(_loaded_tokenizer.encode(stop_token, add_special_tokens=False), dtype=torch.long) for stop_token in stops]
+ self.encounters = encounters
+
+ def __call__(self, input_ids: torch.LongTensor, scores: torch.FloatTensor):
+ for stop in self.stops:
+ if len(input_ids[0]) >= len(stop) and torch.all(stop.to(input_ids.device) == input_ids[0][-len(stop):]).item():
+ self.encounters -= 1
+ if self.encounters == 0:
+ return True
+ return False
+
+ stop_criteria_list = StoppingCriteriaList([StopGenerationCriteria(stops=stop_list)])
+ else:
+ stop_criteria_list = None
+
+
+ hf_generate_kwargs = {
+ 'max_new_tokens': generate_kwargs.get('max_tokens', 512),
+ 'temperature': generate_kwargs.get('temperature', 0.8),
+ 'top_p': generate_kwargs.get('top_p', 0.8),
+ 'top_k': generate_kwargs.get('top_k', 10),
+ 'repetition_penalty': generate_kwargs.get('repeat_penalty', 1.3),
+ 'do_sample': True if generate_kwargs.get('temperature', 1.0) > 0 else False,
+ 'stopping_criteria': stop_criteria_list,
+ 'pad_token_id': _loaded_tokenizer.eos_token_id,
+ 'eos_token_id': _loaded_tokenizer.eos_token_id,
+
+ }
+
+ result = generator(chat_prompt, **hf_generate_kwargs)
+ generated_text = result[0]['generated_text']
+
+ if generated_text.startswith(chat_prompt):
+ llm_result_content = generated_text[len(chat_prompt):].strip()
+ else:
+ llm_result_content = generated_text.strip()
+
+
+ except Exception as e:
+ free_gpu_memory()
+ return (f"Error during inference with '{model}': {e}", text)
+
+
+ if not stay_on_gpu and _model_is_on_gpu:
+ print(f"Offloading {model} from GPU after run as stay on GPU is disabled.")
+ free_gpu_memory()
+ elif stay_on_gpu and _model_is_on_gpu:
+ print(f"{model} remains on GPU.")
+ elif not _model_is_on_gpu:
+ print(f"{model} remains on CPU.")
+
+
+ return (llm_result_content, text)
+
+class Generated_Output:
+ @classmethod
+ def INPUT_TYPES(cls):
+ return {
+ "required": {
+ "text": (anytype, {}),
+ },
+ "hidden": {
+ "unique_id": "UNIQUE_ID", "extra_pnginfo": "EXTRA_PNGINFO",
+ },
+ }
+
+ CATEGORY = "LLM_Hub"
+ FUNCTION = "main"
+ RETURN_TYPES = ()
+ RETURN_NAMES = ()
+ OUTPUT_NODE = True
+
+ def main(self, text, unique_id=None, extra_pnginfo=None):
+ if unique_id is not None and extra_pnginfo is not None and len(extra_pnginfo) > 0:
+ workflow = None
+ if "workflow" in extra_pnginfo:
+ workflow = extra_pnginfo["workflow"]
+ node = None
+ if workflow and "nodes" in workflow:
+ node = next((x for x in workflow["nodes"] if str(x["id"]) == unique_id), None)
+ if node:
+ node["widgets_values"] = [str(text)]
+ return {"ui": {"text": (str(text),)}}
+
+
+class LLM_Settings:
+ @classmethod
+ def INPUT_TYPES(cls):
+ return {
+ "required": {
+ "temperature": ("FLOAT", {"default": 0.8, "min": 0.1, "step": 0.01, "tooltip": "How creative or crazy the text is. High means wild text, low means boring text."}),
+ "top_p": ("FLOAT", {"default": 0.8, "min": 0.1, "step": 0.01, "tooltip": "Picks words that are good enough. High means more choices, low means very few choices."}),
+ "top_k": ("INT", {"default": 10, "min": 0, "tooltip": "Picks from the best X words. High X means many choices, low X means few choices. X = value"}),
+ "repetition_penalty": ("FLOAT", {"default": 1.3, "min": 0.1, "step": 0.01, "tooltip": "Stops the text from saying the same thing too many times. High means less repeating."}),
+ }
+ }
+
+ CATEGORY = "LLM_Hub"
+ FUNCTION = "main"
+ RETURN_TYPES = ("SETTINGS_FOR_LLM",)
+ RETURN_NAMES = ("settings",)
+
+ def main(self, temperature=0.8, top_p=0.8, top_k=10, repetition_penalty=1.3):
+ options_config = {
+ "temperature": temperature,
+ "top_p": top_p,
+ "top_k": top_k,
+ "repetition_penalty": repetition_penalty,
+ }
+
+ return (options_config,)
+
+
+NODE_CLASS_MAPPINGS = {
+ "LLM_Hub": LLM_Hub,
+ "LLM_Settings": LLM_Settings,
+ "Generated_Output": Generated_Output,
+}
+
+NODE_DISPLAY_NAME_MAPPINGS = {
+ "LLM_Hub": "LLM Hub",
+ "LLM_Settings": "LLM Settings",
+ "Generated_Output": "Generated Output",
+}
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..26c9e27
--- /dev/null
+++ b/README.md
@@ -0,0 +1,103 @@
+## 🧠 LLM Hub
+
+Utilize the power of an LLM into ComfyUI to transform your text-to-image and text-to-video ideas into highly detailed prompts for generation while giving you full control.
+
+## 🤖 Usage
+
+
+
+## 📝 Requirements
+
+- Create a directory named **`LLMs`** inside **`ComfyUI/models/text_encoders/`**
+- Create a another new directory for each LLM with the model name inside **`LLMs`**.
+- Place your LLM models in their respective directory.
+- Every .safetensors model needs the .json files and the model should be named **`model.safetensors`**
+
+How your directory structure should look like:
+```
+ComfyUI/
+└── models/
+ └── text_encoders/
+ └── LLMs/
+ └── GGUF_model/
+ └── model.gguf
+ └── safetensors_model/
+ └── model.safetensors
+ └── config.json
+ └── tokenizer.json
+ └── tokenizer_config.json
+ └── generation_config.json (Optional)
+ └── special_tokens_map.json (Optional)
+```
+
+GGUF models don't need to be named "model.gguf".
+
+## 🛠️ Installation
+
+- Run the following commands:
+
+For activating venv:
+```
+cd path/to/your/ComfyUI
+```
+Linux:
+```
+source venv/bin/activate
+```
+
+Windows:
+```
+.venv\Scripts\activate
+```
+
+Go to your custom nodes folder:
+```
+cd custom_nodes
+```
+
+Afterwards clone the repo:
+```
+git clone https://github.com/X/ComfyUI_LLM_Hub
+```
+
+Go inside the node folder:
+```
+cd ComfyUI_LLM_Hub
+```
+
+If you are using a venv:
+```
+pip install -r --verbose requirements.txt
+```
+- You can delete **`"--verbose"`** if you don't want to see the process of the compiling.
+
+For the portable version of ComfyUI:
+```
+C:/path/to/your/ComfyUI_portable/python_embedded/Scripts/pip.exe install -r requirements.txt
+```
+
+## ⚙️ LLM Settings
+
+It offers a range of configurable parameters allowing for precise control over the text generation process and model behavior.
+
+The values on this node are also the defaults that `LLM Hub` uses when `LLM Settings` isn't connected.
+
+Breif overview of the parameters:
+
+- **`temperature:`** Controls the randomness of the output. Lower values (**e.g., 0.2-0.5**): Make the output more focused, predictable, and deterministic.
+ Ideal for tasks requiring factual, precise, or consistent responses. Higher values (**e.g., 0.7-1.0**): Increase creativity and randomness, allowing the model to take more risks. Can lead to more imaginative but potentially less coherent results.
+ `Default: 0.8`
+- **`top_p:`** Filters the set of possible next tokens by cumulative probability. The model only considers tokens whose cumulative probability sum up to `top_p`.Lower values (**e.g., 0.5**): Narrows the selection to only the most probable tokens, improving coherence and reducing the chance of irrelevant words.
+ Higher values (**e.g., 0.9**): Allows for a broader range of tokens, increasing randomness. `Default: 0.8`
+- **`top_k:`** Limits the sampling pool to the k most probable next tokens. Lower values (**e.g., 5-20**): Focuses generation on the top choices, making output more predictable.
+ Higher values (**e.g., 50-100**): Expands the options, outputing more creative text. `Default: 10`
+- **`repetition_penalty:`** Discourages the model from repeating words or phrases that have already appeared in the generated text. Values greater than 1 (**e.g., 1.1-1.5**): Penalize repeated tokens, making them less likely to be chosen again. Essential for preventing repetitive loops or boilerplate text.
+ A value of 1: No penalty applied. `Default: 1.3`
+
+## 📚 Resources
+
+- Parameter settings
+- System prompts, instructions, etc.
+
+## 📄 License
+Released under the MIT License. Feel free to use and modify it for your projects, commercial or personal.
diff --git a/__init__.py b/__init__.py
new file mode 100644
index 0000000..217630c
--- /dev/null
+++ b/__init__.py
@@ -0,0 +1 @@
+from .LLM_Hub import *
diff --git a/img/usage.png b/img/usage.png
new file mode 100644
index 0000000000000000000000000000000000000000..2379f887646667ec2af28367a122fe95fc30946d
GIT binary patch
literal 130885
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