Files
Creepybits-World_weaver/README.md
T
Creepybits de746aaecd Add API Keys section to README
Added instructions for enabling multi-key dropdown with API keys.
2025-12-26 22:04:40 +01:00

81 lines
3.4 KiB
Markdown

# 🌍 World Weaver: The Consistent Character System
**Status:** V1.0 - Active Development (Initial Private Commit: 2025-11-09)
___
### Todo
* Finetune LLM for local use
---
## 🎯 The Problem: Why Consistency is Broken
In generative AI, true character consistency is an illusion built on fragile dependencies. Traditional methods rely on complex, heavy files:
* ❌ **LoRAs:** Require training, large files, and often fail when changing clothes or environments.
* ❌ **IP-Adapters / FaceSwap:** Require manual intervention and often cause flickering in video.
* ❌ **ControlNet:** Good for pose, but fails to maintain the likeness's subtle essence.
## ✨ The Solution: Written DNA
The **World Weaver System** solves this by establishing **Textual Inheritance**. It is a unique methodology that uses a suite of connected workflows and custom prompt logic to force the diffusion model to respect an unshakeable, text-based blueprint—the character's **DNA**.
**Results:** Flawless character consistency maintained across radical changes in lighting, pose, clothing, and environment, without any external files required for the core likeness.
---
## 🏗️ Core Components (The System Architecture)
The World Weaver is an ecosystem of three key parts:
### 1. [The Prompt Helper](./docs/Prompt_Helper.md) (Discovery)
*(JSON included in this repo)*
* **Function:** Uses the Gemini Vision API to analyze any image and convert it into a perfectly structured, ready-to-use text description (the character's DNA).
### 2. [The Genesis](./docs/Genesis.md) (Tester)
*(JSON and Custom Node included in this repo)*
* **Function:** A simple workflow that will test your prompt before you decide if you want to save it to your database.
### 3. [The Character Vault](./docs/Character_Vault.md) (Database)
*(JSON and Custom Node included in this repo)*
* **Function:** A database tool that permanently saves the character's DNA to your ComfyUI file system for instant, one-click retrieval in future projects.
### 4. [The World Weaver](./docs/World_weaver.md) (The Engine)
*(JSON included in this repo)*
* **Function:** The main, complex workflow that combines the character DNA with modular inputs for Clothes, Action, and World, enabling seamless creation of new, consistent scenes.
### 5. The API Keys
To enable the multi-key dropdown:
1. Navigate to custom_nodes/Creepy_nodes/assets/scripts/.
2. Open (or rename) api_keys_config.json.
3. Add your keys by pointing to the text files containing them:
{
"Gemini Free": "C:\\Path\\To\\gemini_api_key_free.txt",
"Gemini Paid": "C:\\Path\\To\\gemini_api_key_paid.txt"
}
---
### Examples
<img width="870" height="727" alt="Skärmbild 2025-11-13 162938" src="https://github.com/user-attachments/assets/29b21607-c721-474d-8cb7-12c0b4d74f34" />
![580799714_10163723144717070_4810933983165315459_n](https://github.com/user-attachments/assets/abce7489-85e7-45a4-a2c2-bb0f6d5c5b3e)
___
## 🚀 Get Started & Learn the Method
This repository contains the foundational components. To fully understand the philosophy, please visit my channels:
* **📺 Video Tutorial (The Masterclass):** [World Weaver Masterclass](https://www.youtube.com/watch?v=EzmYPvP-oZU&list=PLabSj7CHUKn3yK8lOmKrzwxv8ZDkpM6TT)
* **✍️ Deep Dive Article (The Concept):** [Creating Consistent AI Characters Without LoRAs or ReActor](https://zanno.se/creating-consistent-ai-characters-without-loras-or-reactor/)
---
Licence: MIT
Contact: business@zanno.se