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. 💋