OrakulStorm commited on
Commit
bee940e
·
verified ·
1 Parent(s): c0556cd

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +30 -82
README.md CHANGED
@@ -12,7 +12,6 @@ pipeline_tag: text-to-image
12
 
13
  # Orakul Studio - Zero-Disk VRAM Streaming Engine
14
 
15
- [🇬🇧 English](#-english) | [🇺🇦 Українська](#-українська) | [🇷🇺 Русский](#-русский)
16
 
17
 
18
  > [!IMPORTANT]
@@ -24,99 +23,48 @@ pipeline_tag: text-to-image
24
  > * **Speed is Key:** The only requirement is a fast and stable internet connection. If your system can already run Flux 2, you can stream models and LoRAs of **any size** (even 50GB–100GB+) seamlessly without freeing up a single gigabyte of storage!
25
 
26
 
27
- ---
28
-
29
- ## 🇬🇧 English
30
-
31
- ### What is Orakul Studio Zero-Disk?
32
- **Orakul Studio** is an experimental library of AI models, LoRAs, and custom merges.
33
-
34
- If your SSD is constantly out of space, this project allows you to stream model weights **directly from Hugging Face into your System RAM / GPU VRAM** during generation bypassing your local hard drive completely (0 bytes written to disk).
35
-
36
- ### What is stored in this repository?
37
- * **Custom LoRAs** (character, style, and thematic trained weights).
38
- * **Experimental Merges & Checkpoints**.
39
- * **Direct ComfyUI Node** integration code for diskless streaming.
40
-
41
- ---
42
-
43
-
44
- ### How to Use
45
- 1. In ComfyUI, add the **Viking HF LoRA (Zero-Disk)** node.
46
- 2. Connect `MODEL` and `CLIP` inputs just like a standard `Load LoRA` node.
47
- 3. Set `filename` to the desired path from the repo (e.g., `loras/my_style/model.safetensors`).
48
- 4. Click **Queue Prompt**. The node streams the file directly over HTTPS, patches your model, and instantly flushes system RAM to keep your system fast and stable.
49
-
50
- ---
51
-
52
- ## 🇺🇦 Українська
53
 
54
- ### Що таке Orakul Studio Zero-Disk?
55
- **Orakul Studio** - це експериментальна бібліотека нейромережевих моделей, LoRA та кастомних мерджів.
56
 
57
- Якщо у вас постійно заповнений SSD, цей проєкт дозволяє потоково завантажувати ваги моделей **напряму з Hugging Face у системну оперативну пам'ять (RAM) та відеопам'ять (VRAM)** під час генерації. Ваш жорсткий диск взага генериує 0 байт запису.
58
 
59
- ### Що міститься в цьому репозиторії?
60
- * **Кастомні LoRA** (персонажі, стилі, тематичні ваги).
61
- * **Експериментальні чекпоінти та мерджі**.
62
- * **Код кастомної ноди для ComfyUI** для прямого стрімінгу.
63
 
64
- ---
65
-
66
- ### Як встановити ноду в ComfyUI
67
-
68
- 1. Перейдіть у папку ComfyUI: `ComfyUI/custom_nodes/`.
69
- 2. Створіть папку `ComfyUI-Viking-ZeroDisk`.
70
- 3. Усередині створіть файл `__init__.py`.
71
- 4. Вставте код ноди (наведений у розділі English вище) у файл `__init__.py`.
72
- 5. Перезапустіть ComfyUI.
73
-
74
- ---
75
-
76
- ### Як використовувати
77
- 1. У ComfyUI додайте ноду **Viking HF LoRA (Zero-Disk)**.
78
- 2. Підключіть входи `MODEL` та `CLIP` як у звичайній ноді LoRA.
79
- 3. У полі `filename` вкажіть шлях до файлу з репозиторію (наприклад, `loras/my_style/model.safetensors`).
80
- 4. Натисніть **Queue Prompt**. Нода завантажить веси через мережу, прошиє модель і одразу очистить оперативну пам'ять, щоб ваш ПК працював максимально швидко.
81
 
82
- ---
83
-
84
- ## 🇷🇺 Русский
85
-
86
- ### Что такое Orakul Studio Zero-Disk?
87
- **Orakul Studio** - это экспериментальная библиотека нейросетевых моделей, LoRA и кастомных мерджей.
88
 
 
 
 
 
 
 
89
 
90
- > [!IMPORTANT]
91
- > **Важная информация о требованиях к оперативной памяти (RAM/VRAM) и интернет-соединению**
92
- >
93
- > * **Идентичный объем используемой памяти:** Потребление памяти (оперативной памяти системы и видеопамяти VRAM) остается **абсолютно одинаковым** независимо от того, загружаете ли вы модель локально или используете потоковую передачу через технологию Zero-Disk.
94
- > * **Отсутствие нагрузки на локальный диск:** На вашем локальном накопителе не сохраняется **ни одного байта** данных. Временные файлы и локальные кэши не создаются, а значит, отсутствуют циклы записи на SSD/HDD и их износ.
95
- > * **Решение для медленных накопителей:** Если вы используете обычный жесткий диск (HDD) или ваш SSD заполнен, потоковая передача через быстрое интернет-соединение позволяет полностью обойти ограничения скорости локального накопителя.
96
- > * **Скорость главное условие:** Единственное требование наличие быстрого и стабильного интернет-соединения. Если ваша система уже способна запускать Flux 2, вы можете использовать модели и LoRA-адаптеры **любого размера** (даже 50–100 ГБ и более) без необходимости освобождать место на диске!
97
 
 
98
 
99
- Если у вас постоянно забит SSD и не хватает места под гигабайты моделей, этот проект позволяет стримить веса **напрямую из облака Hugging Face в оперативную память (RAM) и VRAM видеокарты** прямо в момент нажатия кнопки генерации. На жесткий диск ничего не сохраняется (0 байт записи).
 
 
 
 
 
 
100
 
101
- ### Что публикуется в этом репозитории?
102
- * **Авторские LoRA** (персонажи, стили, детализация).
103
- * **Экспериментальные мерджи и чекпоинты**.
104
- * **Код кастомной ноды ComfyUI** для потоковой загрузки без диска.
105
 
106
  ---
107
 
108
- ### Как установить ноду в ComfyUI
109
-
110
- 1. Зайдите в папку ComfyUI: `ComfyUI/custom_nodes/`.
111
- 2. Создайте папку `ComfyUI-Viking-ZeroDisk`.
112
- 3. Внутри создайте файл `__init__.py`.
113
- 4. Скопируйте код ноды (из раздела English выше) и вставьте его в `__init__.py`.
114
- 5. Перезапустите ComfyUI.
115
 
116
- ---
 
 
 
 
 
 
117
 
118
- ### Как пользоваться в ComfyUI
119
- 1. В интерфейсе ComfyUI добавьте ноду **Viking HF LoRA (Zero-Disk)**.
120
- 2. Подключите входы `MODEL` и `CLIP` точь-в-точь как у обычной ноды `Load LoRA`.
121
- 3. В поле `filename` вставьте путь к нужной LoRA из репозитория (например, `loras/my_style/model.safetensors`).
122
- 4. Нажмите **Queue Prompt**. Нода подтянет файл по сети, прошьет веса в VRAM и сразу вычистит ОЗУ, освободив ресурсы под работу сэмплера и тяжелых базовых моделей (например, Flux 2).
 
12
 
13
  # Orakul Studio - Zero-Disk VRAM Streaming Engine
14
 
 
15
 
16
 
17
  > [!IMPORTANT]
 
23
  > * **Speed is Key:** The only requirement is a fast and stable internet connection. If your system can already run Flux 2, you can stream models and LoRAs of **any size** (even 50GB–100GB+) seamlessly without freeing up a single gigabyte of storage!
24
 
25
 
26
+ # Viking HF Multi-LoRA Loader (Zero-Disk VRAM/RAM Streaming Engine)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
27
 
28
+ An official, free companion API node for my experimental and high-rank models hosted on Civitai.
 
29
 
30
+ Many of my experimental LoRA models are 20–40 GB in size. If you have a fast internet connection but don’t want to fill up terabytes of your SSD space just for testing, this node is your solution. It allows you to stream large model weights directly from my Hugging Face archive into your PC’s RAM/VRAM, completely bypassing the need to save files to your local disk.
31
 
 
 
 
 
32
 
33
+ ![Снимок экрана 2026-11-01 163514](https://cdn-uploads.huggingface.co/production/uploads/66e19348dd56688c29a26b45/GdFO_xGDT5CMTwwt3o7A2.png)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
34
 
35
+ ## Key Advantages
 
 
 
 
 
36
 
37
+ * **Zero-Disk Architecture:** Models are downloaded directly into RAM. You can test dozens of massive LoRA models without them occupying a single megabyte of space on your storage drive.
38
+ * **Identical RAM Usage:** The node consumes **exactly the same amount** of RAM as it would if you were loading a model already saved on your local disk. No extra resources are wasted.
39
+ * **Smart RAM Cache:** With the `keep_in_ram` toggle, you control the model's lifecycle:
40
+ * **ON:** The model is loaded into RAM once and remains there, allowing for near-instant subsequent generations.
41
+ * **OFF:** The model is downloaded, used to generate an image, and then **immediately cleared from memory**, freeing up system resources entirely.
42
+ * **4 Slots for Multi-Generation:** The node features 4 independent slots, each with its own strength settings (`str_model`, `str_clip`). You can blend different models on the fly—for example, by combining a character-specific LoRA with a style-based LoRA (such as one for tattoos) in a single generation. ---
43
 
44
+ ## How It Works (For Users of My Models)
 
 
 
 
 
 
45
 
46
+ The node is hardcoded to point to my repository (`OrakulStorm/Zero-Disk-VRAM-Streaming-Engine`). This ensures everything stays configured correctly, sparing you from having to enter redundant information. The interface follows a simple "copy-paste" workflow.
47
 
48
+ **Steps to follow:**
49
+ 1. Go to my Hugging Face repository and open the *Files and versions* tab.
50
+ 2. Copy the path to the desired `.safetensors` file.
51
+ * *Example of a copied path:* `FLUX2-RANK2048-VanGogh/r2048f2dvangog.safetensors`
52
+ 3. Paste this path into the **`filename_1`** field (or any available slot in the node).
53
+ 4. Ensure the **`lora_1_switch`** toggle is set to ON.
54
+ 5. Click **Queue Prompt** — that’s it! The node will automatically fetch the required model from my repository directly into memory and generate the result.
55
 
56
+ *(You do not need to change the `repo_id` field in the ComfyUI interface; it serves merely as a visual indicator of which repository is being accessed.)*
 
 
 
57
 
58
  ---
59
 
60
+ ## 👨‍💻 For Advanced Users (Using Other Repositories)
 
 
 
 
 
 
61
 
62
+ The node’s code is fully open-source. If you are familiar with Python and would like to use this "Zero-Disk" streaming engine with **other models** (such as official Flux weights, Diffusers, etc.), you can easily detach the node from my repository. **How ​​to change the base repository:**
63
+ 1. Open the `__init__.py` file (located in the `custom_nodes/VikingHF` node folder) using any text editor (e.g., Notepad++).
64
+ 2. Locate the `class VikingHFMultiLoraLoader:` definition and scroll down to the `def INPUT_TYPES(s):` block.
65
+ 3. Within the slot settings, find the following line:
66
+ `"repo_id_1": ("STRING", {"default": "OrakulStorm/Zero-Disk-VRAM-Streaming-Engine"}),`
67
+ 4. Replace `"OrakulStorm/Zero-Disk-VRAM-Streaming-Engine"` with the ID of your desired Hugging Face repository.
68
+ 5. Save the file and restart ComfyUI.
69
 
70
+ You can now provide paths to `.safetensors` files from your target repository. If the repository is private, remember to enter your access token into the `hf_token` field within the node's interface.