leylahviolet/violet-essentia-ex-machina

🌸 Violet Essentia Ex Machina

A custom-distilled ONNX LLM, trained for prompt compression and aesthetic translation inside the Violet Tools ecosystem.

---

✨ Overview

Violet Essentia Ex Machina is a specialized language model designed to transform bloated, verbose text-to-image prompts into elegant, efficient keyword sets — perfect for Danbooru-style tagging or constrained-token workflows.

It integrates directly with ComfyUI Violet Tools through the Essence Extractor node, which plugs seamlessly into the Encoding Enchantress.

• 🪄 Essence Extractor: Loads this model and applies optional safety filters, token limits, and compression logic.
• 🧩 Encoding Enchantress: Works normally without it, but becomes smarter and sleeker when Essence Extractor is wired in.

---

⚙️ Files Included

This repository contains all the necessary artifacts to load the model and its tokenizer:

• violet-essentia-ex-machina-int8.onnx – ONNX graph
• violet-essentia-ex-machina-int8.onnx.data – tensor weights (~4.12 GB)
• tokenizer.json – full tokenizer definition
• tokenizer.model – SentencePiece model
• tokenizer_config.json – tokenizer settings
• special_tokens_map.json – mapping for special tokens
• added_tokens.json – any custom vocab additions
• genai_config.json – runtime configuration
• chat_template.jinja – chat formatting template

---

🛠️ Usage in ComfyUI

Once Violet Tools is installed, the Essence Extractor node will automatically check for this model.

• On first use, if the model is not present, the node will offer to download it from this repo.
• Downloaded files are cached in ComfyUI/models/violet_essentia/.
• If Essence Extractor is unused or fails, Encoding Enchantress optionally optimizes prompts with an algorithmic fallback, then encodes prompts normally.

Example Wiring

Essence Extractor → Encoding Enchantress → Sampler

---

🌈 Node Settings

• Safety Level: SFW | NSFW | Unspecified
• Token Minimum / Maximum: custom range
• Versioning: Manifest-based; supports multiple model versions side-by-side

---

📥 Installation

1. Clone or install Violet Tools into ComfyUI:

git clone https://github.com/leylahviolet/ComfyUI-Violet-Tools

2. Add an Essence Extractor node in your graph.
3. On first run, it will prompt to fetch Violet Essentia Ex Machina from this Hugging Face repo.

---

💜 License & Credits

• Created by Leylah Violet with love, science, and far too much coffee.
• Distributed for art, research, and community.

Please cite Violet Tools and link back here if you incorporate this model into your projects. 🌸

---

🔗 Related Repos

• ComfyUI Violet Tools
• Ultralytics Detector Provider (ComfyUI)

---

Violet Essentia Ex Machina LLM and the Essence Extractor node that provides it are optional. Encoding Enchantress will still sing, but with Essentia Ex Machina she whispers stable diffusion model-tuned poetry straight to your sampler. 💋