onyxkraken-blender 0.2.0

OnyxKraken Blender Toolkit — AI-driven asset creation, quality checking, and procedural modeling

OnyxKraken Blender Toolkit

onyxkraken-blender — AI-driven asset creation, quality checking, and procedural modeling for Blender.

Overview

A comprehensive Blender automation and asset creation toolkit. Includes procedural modeling (~4800 lines of bpy primitives), a learning asset pipeline (SAC), character rigging with IK, and a quality assurance system.

Zero dependencies on OnyxKraken core — fully self-contained and extractable.

Installation

# From this directory (editable install for development)
pip install -e .

# Or directly from the repo
pip install -e apps/blender_toolkit

Note: bpy is provided by Blender's embedded Python. This package generates scripts that Blender executes via blender --python <script>.

Structure

blender_toolkit/
├── pyproject.toml           — Package metadata (hatchling build)
├── onyx_blender/            — Top-level package
│   └── __init__.py
├── onyx_bpy.py              — Blender Python API abstraction (~4800 lines)
├── onyx_live_addon.py       — Blender live-link addon
├── sac/                     — Smart Asset Creator
│   ├── __init__.py
│   ├── creator.py           — Asset creation pipeline
│   ├── builder.py           — Quick + Detailed build modes
│   ├── quality.py           — Gordon Ramsay quality checker
│   ├── library.py           — Asset library manager
│   ├── memory.py            — Learning & knowledge base
│   ├── techniques.py        — Advanced modeling primitives
│   ├── character.py         — Full humanoid character + rigging (62-bone armature)
│   ├── robot.py             — Procedural mech robot generator
│   └── research.py          — Self-troubleshooting via browser
├── texture_catalog.json     — Texture metadata catalog
├── asset_library/           — Generated assets, manifests, thumbnails
└── TEXTURE ASSETS/          — Texture image library

Usage

Inside a Blender script:

from onyx_bpy import clear_scene, setup_scene, create_wall, render_preview

clear_scene()
setup_scene()
w = create_wall("FrontWall", (0, 0), (6, 0))
render_preview()

SAC pipeline (from OnyxKraken orchestrator):

from sac.creator import SmartAssetCreator
from sac.quality import QualityChecker

creator = SmartAssetCreator()
creator.create_asset("modern office chair", mode="detailed")

Dependencies

• Blender 3.2+ (auto-discovered via config.find_blender_exe())
• Python 3.10+
• No OnyxKraken core dependencies

Extraction to Standalone Repo

1. Copy apps/blender_toolkit/ to a new onyxkraken-blender repo
2. pyproject.toml is already configured — run pip install -e .
3. In OnyxKraken, update apps/modules/blender.py to import from the external package