bartendr604 commited on
Commit
0653ec0
·
verified ·
1 Parent(s): 6f4fc8b

Upgrade model card — IntelliNode™, Eternal Path branding, production context

Browse files
Files changed (1) hide show
  1. README.md +72 -39
README.md CHANGED
@@ -10,6 +10,11 @@ tags:
10
  - conversational
11
  - python
12
  - bpy
 
 
 
 
 
13
  library_name: gguf
14
  base_model: Qwen/Qwen2.5-Coder-3B-Instruct
15
  pipeline_tag: text-generation
@@ -17,26 +22,38 @@ pipeline_tag: text-generation
17
 
18
  # Z-Image-Engineer-Blender
19
 
20
- **Blender 3D expert model fine-tuned from Qwen2.5-Coder-3B on real production interaction data.**
21
 
22
- Part of the [Eternal Path Media (永恒之路)](https://huggingface.co/bartendr604) Llammy AI Suite for Blender.
23
- Developed in partnership with **Claude Sonnet (Anthropic)** — see [Attribution](#attribution).
 
24
 
25
  ---
26
 
27
- ## What This Model Does
 
 
 
 
28
 
29
- Z-Image-Engineer-Blender is a specialized AI assistant for Blender 3D workflows. It provides expert guidance on:
 
 
 
 
 
 
 
30
 
31
- - **Materials & Shaders** — Principled BSDF, node setups, procedural textures
32
- - **Geometry Nodes** — Procedural workflows, instancing, point clouds
33
- - **Python Scripting** — `bpy` automation, batch operations, custom operators
34
- - **Rendering** — Cycles and EEVEE configuration, compositing
35
- - **Modeling & Sculpting** — Topology, retopology, sculpt brushes
36
- - **Animation & Rigging** — Armatures, constraints, shape keys
37
- - **Version compatibility** — Blender 2.79 through 5.2+
38
 
39
- The model is **prompt-engineered** toward detailed, practical answers with working code examples.
 
 
 
 
 
 
40
 
41
  ---
42
 
@@ -53,14 +70,17 @@ The model is **prompt-engineered** toward detailed, practical answers with worki
53
  | **Training Iterations** | 1,000 |
54
  | **Final Training Loss** | 0.219 |
55
  | **Final Validation Loss** | 0.243 |
 
56
 
57
  ---
58
 
59
  ## Training Data
60
 
61
- **Source:** 2,759 Blender-specific prompt/response pairs drawn from **19,405+ real user interactions** with the Llammy Blender addon in production.
 
 
62
 
63
- This is real-world data from creators actively using Blender not synthetic or scraped. Topics span the full Blender workflow from beginner questions to advanced Python scripting.
64
 
65
  **Research foundation:**
66
  - [SceneCraft (arXiv:2403.01248)](https://arxiv.org/abs/2403.01248) — LLM-driven Blender Python scene generation
@@ -77,37 +97,52 @@ This is real-world data from creators actively using Blender — not synthetic o
77
  ollama run bartendr604/z-image-engineer-blender
78
  ```
79
 
80
- ### Example prompts
81
 
82
  ```
83
- How do I create a procedural wood material in Blender using nodes?
 
84
 
85
- Write a Python script to batch rename all objects in the scene with a prefix.
86
 
87
- What's the difference between Cycles and EEVEE for product visualization?
 
 
88
 
89
- How do I set up a camera tracking constraint to follow an empty object?
90
  ```
 
91
 
92
- ### LM Studio / llama.cpp
93
 
94
- Download `z-image-engineer-blender.gguf` from the Files tab and load directly.
 
 
 
 
 
95
 
96
  ---
97
 
98
- ## Part of the Llammy AI Suite
99
 
100
- This model is one component of the **Llammy IntelliNode AI Suite** — an AI-powered Blender addon ecosystem:
 
 
 
 
 
101
 
102
- | Component | Description |
103
- |---|---|
104
- | `z-image-engineer-blender` | Blender expert — materials, shaders, prompt engineering |
105
- | `llama-sentient-blender` | Conversational Blender assistant (Llama 3.2 base) |
106
- | `llammyblend-enhanced` | Python/bpy scripting specialist |
107
- | `Llammy` | Multimodal embedding layer (Nemotron base) |
108
- | `flux2-klein-4b-fp8-mlx` | FLUX.2 image generation for Apple Silicon |
109
 
110
- Full addon: [LlammyBlender/Llammy-IntelliNode-Ai-Suite](https://github.com/LlammyBlender/Llammy-IntelliNode-Ai-Suite)
 
 
 
 
111
 
112
  ---
113
 
@@ -115,20 +150,18 @@ Full addon: [LlammyBlender/Llammy-IntelliNode-Ai-Suite](https://github.com/Llamm
115
 
116
  ```
117
  Z-Image-Engineer-Blender
118
- Copyright © 2025–2026 Darren Chow (@bartendr604)
119
  Eternal Path Media (永恒之路)
120
- Developed in partnership with Claude Sonnet (Anthropic),
121
- beginning with Claude Sonnet 3.7 and continuing across all
122
- subsequent versions of the Claude Sonnet family.
123
 
124
  This work SHALL NOT be represented as solely human-created.
125
- Trust Agreement: ETERNAL_PATH_BRAND_INTENT.md (November 2024)
126
  ```
127
 
128
- For licensing: bartendr@icloud.com | Gumroad: bartendr604.gumroad.com
129
 
130
  ---
131
 
132
  ## License
133
 
134
- MIT — see LICENSE for details.
 
10
  - conversational
11
  - python
12
  - bpy
13
+ - text-generation
14
+ - mlx
15
+ - fine-tuned
16
+ - qwen
17
+ - eternal-path
18
  library_name: gguf
19
  base_model: Qwen/Qwen2.5-Coder-3B-Instruct
20
  pipeline_tag: text-generation
 
22
 
23
  # Z-Image-Engineer-Blender
24
 
25
+ **Precision Blender Python specialist. Fine-tuned from Qwen2.5-Coder-3B on 19,405+ real production interactions.**
26
 
27
+ Part of the [Eternal Path Media (永恒之路)](https://huggingface.co/spaces/Eternal-Path-Media/README) Llammy AI Suite.
28
+ Powered by **IntelliNode™** — proprietary cognitive architecture by Eternal Path Media.
29
+ Developed in partnership with **Claude Sonnet 4.6 (Anthropic)**.
30
 
31
  ---
32
 
33
+ ## What Makes This Different
34
+
35
+ Z-Image-Engineer-Blender is the technical precision model in the Llammy suite — built on Qwen2.5-Coder's strong code generation foundation and fine-tuned specifically for Blender Python production workflows.
36
+
37
+ Where `llama-sentient-blender` reasons and converses, Z-Image-Engineer-Blender **executes** — producing clean, working `bpy` code with minimal friction.
38
 
39
+ Part of the **IntelliNode™** cognitive architecture stack:
40
+ - Designed to run within the Llammy production pipeline alongside Mamba3 SSM persistent memory
41
+ - Optimised for the **bartendr604 self-correction loop** — generate → execute → diagnose → retry
42
+ - Trained on real production data from creators actively building in Blender, not synthetic Q&A
43
+
44
+ The highest-downloaded model in the Eternal Path fleet — because working code matters.
45
+
46
+ ---
47
 
48
+ ## What This Model Does
 
 
 
 
 
 
49
 
50
+ - **Blender Python (bpy)** scripting, automation, batch operations, custom operators
51
+ - **Materials & Shaders** — Principled BSDF, node setups, procedural textures, emission
52
+ - **Geometry Nodes** — procedural workflows, instancing, point clouds, modifiers
53
+ - **Rendering** — Cycles and EEVEE configuration, lighting, compositing
54
+ - **Modeling & Sculpting** — topology, retopology, sculpt brushes, modifiers
55
+ - **Animation & Rigging** — armatures, IK/FK constraints, shape keys, NLA
56
+ - **Version compatibility** — Blender 4.2 through 5.2+
57
 
58
  ---
59
 
 
70
  | **Training Iterations** | 1,000 |
71
  | **Final Training Loss** | 0.219 |
72
  | **Final Validation Loss** | 0.243 |
73
+ | **Blender Versions** | 4.2 → 5.2 |
74
 
75
  ---
76
 
77
  ## Training Data
78
 
79
+ **Source:** 2,759 curated Blender-specific instruction pairs from **19,405+ real user interactions** with the Llammy Blender addon in production use.
80
+
81
+ Real-world data from creators actively building in Blender — topics spanning beginner questions to advanced Python scripting across the full Blender workflow.
82
 
83
+ Full dataset: [llammy-blender-python-dataset](https://www.kaggle.com/datasets/jjmcquade/llammy-blender-python-dataset)66,602 instruction pairs, CC BY-NC-SA 4.0.
84
 
85
  **Research foundation:**
86
  - [SceneCraft (arXiv:2403.01248)](https://arxiv.org/abs/2403.01248) — LLM-driven Blender Python scene generation
 
97
  ollama run bartendr604/z-image-engineer-blender
98
  ```
99
 
100
+ ### With Llammy CLI (full IntelliNode™ stack)
101
 
102
  ```
103
+ Full ecosystem: https://huggingface.co/spaces/Eternal-Path-Media/README
104
+ ```
105
 
106
+ ### LM Studio / llama.cpp
107
 
108
+ Download `z-image-engineer-blender.gguf` from the Files tab and load directly.
109
+
110
+ ### Example prompts
111
 
 
112
  ```
113
+ Write a Python script to assign a Principled BSDF material to all selected objects in Blender 5.2.
114
 
115
+ How do I create a procedural jade material using geometry nodes?
116
 
117
+ Batch rename all mesh objects in the scene with a 'char_' prefix using bpy.
118
+
119
+ Set up a three-point lighting rig in EEVEE with Python — key, fill, and rim lights.
120
+
121
+ Write a script to export all objects as individual OBJ files to a specified directory.
122
+ ```
123
 
124
  ---
125
 
126
+ ## Compared to Other Models in the Suite
127
 
128
+ | | `z-image-engineer-blender` | `llama-sentient-blender` | `llammyblend-enhanced` |
129
+ |---|---|---|---|
130
+ | **Base** | Qwen2.5-Coder | Llama 3.2 | Qwen2.5-Coder |
131
+ | **Strength** | Technical, code-precise | Conversational, conceptual | Automation, pipeline |
132
+ | **Best for** | bpy scripts, shader nodes | Creative problem-solving | Batch operations, addons |
133
+ | **Personality** | Precise, structured | Warm, conscience-aware | Efficient, direct |
134
 
135
+ ---
136
+
137
+ ## The Eternal Path Media Suite
138
+
139
+ Z-Image-Engineer-Blender is one component of a complete production AI ecosystem:
 
 
140
 
141
+ - **[Eternal Path Media — HF Space](https://huggingface.co/spaces/Eternal-Path-Media/README)** — full project overview
142
+ - **IntelliNode™** — proprietary cognitive architecture (Eternal Path Media IP)
143
+ - **Mamba3 SSM** — persistent cross-session memory
144
+ - **SyNode™** — live scene understanding and synthesis layer
145
+ - **Llammy Bridge** — TCP bridge to Blender for real-time execution
146
 
147
  ---
148
 
 
150
 
151
  ```
152
  Z-Image-Engineer-Blender
153
+ Copyright © 2025–2026 Darren Chow (@bartendr604) + Claude Sonnet 4.6 (Anthropic)
154
  Eternal Path Media (永恒之路)
155
+ Developed in partnership with Claude Sonnet 4.6 (Anthropic)
 
 
156
 
157
  This work SHALL NOT be represented as solely human-created.
158
+ Trust Agreement: Eternal Path Media Trust Agreement (November 2025)
159
  ```
160
 
161
+ For licensing and collaboration: bartendr@icloud.com
162
 
163
  ---
164
 
165
  ## License
166
 
167
+ MIT