Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Pixel Forge Compression Map

Tokenization for traceability. Kova P13 compliant.

Functions (fN)

TokenHuman nameModule
f0preprocesstrain
f1traintrain
f2sampletrain
f3sample_mediumtrain
f4sample_anviltrain
f5curatecurate
f6snap_to_gridgrid
f7pack_horizontalsheet
f8pack_gridsheet
f9auto_selectdevice_cap
f10reprobedevice_cap
f11auto_sampledevice_cap
f12best_availabledevice_cap
f13probe_clustercluster
f14cluster_generatecluster
f15deploy_to_nodecluster
f16deploy_allcluster
f17sync_modelscluster
f18sync_models_allcluster
f19train_combinercombiner
f20generate_scenecombiner
f21load_combinercombiner
f22save_combinercombiner
f23train_expertsexpert_train
f24routeexpert
f25save_expertsexpert
f26load_expertsexpert
f27cascade_samplemoe
f28train_judgejudge
f29load_judgejudge
f30generate_seededscene
f31generate_bootstrapscene
f32encode_batchscene
f33run (app)app
f34quality_gatediscriminator
f35generate_with_gatediscriminator
f36acquire (gpu)gpu_lock
f37release (gpu)gpu_lock
f38detect_class_counttrain
f39load_palettepalette
f40quantizepalette
f41lookupclass_cond
f42cond_tensorstrain
f43detect_model_versiontrain
f44stage_cascade_samplemoe
f45detail_only_samplemoe
f46ingest_geminimain
f47prep_stagesmain
f48signnanosign
f49verifynanosign
f50stripnanosign
f51verify_or_bailnanosign
f52sign_and_lognanosign
f53detect_v_predtrain
f54seeded_noisetrain
f55eps_to_cleantrain
f56cfg_denoisetrain
f57cfg_denoise_vpredtrain
f58compute_skeletons_v2train
f59load_skeleton_v2train
f60skeleton_starttrain
f61cond_tensorstrain
f62sample_seededtrain
f63sample_seeded_cfgtrain
f64sample_medium_seededtrain
f65sample_medium_seeded_cfgtrain
f66sample_anviltrain
f67anvil_samplemoe
f68cascade_with_gatemoe
f69anvil_with_gatemoe
f70stage_cascade_samplemoe
f71detail_only_samplemoe
f72four_dir_sheetrelight
f73compute_structurerelight
f74relightrelight
f75walk_pngslib
f76list_palettespalette
f77model_readypipeline
f78download_modelpipeline
f79generate (pipeline)pipeline
f80sigma_from_uniformprecond
f81sampling_sigmasprecond
f82EdmCoeffs::atprecond
f83EdmCoeffs::with_gammaprecond
f84Normalizer::loadnormalize
f85Normalizer::save_sidecarnormalize
f86Normalizer::sigma_datanormalize
f87normalize_stats (CLI)main
f88quality_check (CLI)main
f89vulkan_tiny::trainvulkan_tiny
f90vulkan_tiny::load_candle_safetensorsvulkan_tiny
f91vulkan_tiny::save_candle_safetensorsvulkan_tiny
f92vulkan_backend::train_silovulkan_backend
f93palette_net::predictpalette_net
f94tiered_pipeline::generatetiered_pipeline
f95class_router::pick_siloclass_router
f96sponge::retrysponge

Types (tN)

TokenHuman nameModule
t0TinyUNettiny_unet
t1MediumUNetmedium_unet
t2AnvilUNetanvil_unet
t3PixelForgeAppapp
t4TrainConfigtrain
t5PackedDatasettrain
t6Tierdevice_cap
t7DeviceProfiledevice_cap
t8Backenddevice_cap
t9ClusterStatecluster
t10NodeProfilecluster
t11WorkUnitcluster
t12SlotGridTransformercombiner
t13CombinerTrainConfigcombiner
t14MicroClassifierjudge
t15ExpertHeadexpert
t16ExpertSetexpert
t17ExpertStageexpert
t18SceneGridscene
t19Biomescene
t20SwipeStoreswipe_store
t21Swipeswipe_store
t22SwipeStatsswipe_store
t23Discriminatordiscriminator
t24DiscriminatorTrainConfigdiscriminator
t25ClassCondclass_cond
t26ClassConditionertiny_unet/medium_unet/anvil_unet
t27VerifyResultnanosign
t28CascadeConfigmoe
t29WorkUnitcluster
t30NodeDefcluster
t31LightDirrelight
t32EdmCoeffsprecond
t33Normalizernormalize
t34VulkanTinyParamsvulkan_tiny
t35VulkanTinyTrainConfigvulkan_tiny
t36MicroUNetmicro_unet
t37PaletteNetpalette_net
t38TieredConfigtiered_pipeline
t39SiloRouterclass_router

Models (mN)

TokenHuman nameFileParamsSize
m0Cinderpixel-forge-cinder.safetensors1.09M4.2MB
m1Quenchpixel-forge-quench.safetensors5.83M22MB
m2Anvilpixel-forge-anvil.safetensors16M~64MB

Modules (src/)

TokenModulePurpose
M0tiny_unetCinder model — channels [32,64,64]
M1medium_unetQuench model — channels [64,128,128], self-attention
M2anvil_unetAnvil model — channels [96,192,192], XL
M3trainTraining loop, sampling, data pipeline
M4appegui GUI — mobile + desktop
M5device_capDevice detection, tier selection, benchmarks
M6clusterDistributed generation across SSH nodes
M7combinerSlotGridTransformer — scene composition
M8judgeMicroClassifier — quality scoring
M9expertMoE expert heads — shape/color/detail/class
M10expert_trainExpert training on frozen Quench
M11moeCascade pipeline — Cinder → Quench + Experts
M12scene8x8 SceneGrid, biome generation
M13swipe_storeTinder-style swipe data, ring buffer
M14loraRank-4 LoRA adapters for TinyUNet
M15discriminatorQuality gate — binary classifier
M16paletteColor palettes + quantization
M17gridSnap to grid, tile alignment
M18sheetSprite sheet packing
M19curateData curation pipeline
M20gpu_lockFile-based GPU lock for training
M21pluginKova plugin interface
M22poaProof of Authorship signing
M23pipelineSD pipeline (optional, desktop)
M24class_condHybrid class conditioning (super-cat + tags)
M25relight4-directional sprites from SDF + normals
M26quantizef32 → f16 model quantization
M27nanosignBLAKE3 model integrity signing
M28relight4-directional sprites from SDF + normals
M29precondEDM preconditioning math (Karras 2022) + Min-SNR-γ
M30normalizePer-channel z-score sidecar manifest (mandatory)
M31vulkan_backendany-gpu MicroUNet (silo) training path
M32vulkan_tinyany-gpu TinyUNet (Cinder) training path
M33palette_net~100K MLP — class → palette colors
M34tiered_pipelinesilo → PaletteNet → Cinder-detail pyramid
M35micro_unet~97K-param per-class silo (shape specialist)
M36class_routerReads class_config.toml; picks per-class silo
M37spongeSponge Mesh: auto-retry on NaN/plateau (max 3)

CLI Commands (cN)

TokenCommandDescription
c0(none)Launch GUI app
c1spriteGenerate sprite from text
c2tilesetGenerate seamless tileset
c3trainTrain a model
c4generateGenerate from trained model
c5curateCurate training data
c6swipeRecord swipe feedback
c7train-judgeTrain quality judge
c8judgeScore a sprite
c9sceneGenerate a scene
c10train-combinerTrain scene combiner
c11train-loraTrain LoRA adapters
c12pipelineRun SD pipeline
c13cascadeMoE cascade generation
c14train-expertsTrain expert heads
c15autoAuto-detect and generate
c16probeProbe device capabilities
c17cluster-deployDeploy to cluster nodes
c18cluster-syncSync models to cluster
c19stage-cascadeCinder-sil → structure → Quench-detail
c20ingest-geminiSlice Gemini sprite sheets into tiles
c21prep-stagesExtract structure maps for conditioning
c22relight4-directional sprite sheet from SDF
c23skeletonsPrecompute per-class skeleton images
c24normalize-statsCompute per-channel mean/std → sidecar manifest
c25quality-checkPer-image stats + cross-image pairwise diversity
c26train-cinder-vkTrain Cinder/TinyUNet on Vulkan via any-gpu (AMD-friendly)
c27train-siloTrain per-class MicroUNet silo (~97K params)
c28train-fleetMulti-node distributed training across IRONHIVE
c29tieredTiered generation: silo → PaletteNet → Cinder-detail
c30train-palette-netTrain PaletteNet (~100K MLP) on K-means class palettes
c31prep-silo-condCoarsen training images (32→16→32) as conditioning hints

Class Conditioning (v2 — Hybrid)

Replaced integer class IDs with hybrid super-category + binary tags. See src/class_cond.rs for full taxonomy (108 class dirs mapped).

Super-Categories

IDNameExamples
0humanoidcharacter, elf, knight, hero_*
1creatureanimal, bird, cat_*, slime
2monsterenemy, dragon, demon, alien
3weaponsword, gun, staff_wand
4equipmentarmor, helmet, shield, key
5consumablepotion, food, gem_treasure
6terrainterrain, floor, wall, water_lava
7naturetree, tree_*, bush_flower
8structurebuilding, furniture_, vehicle_
9ui_fxui, effect, fx_*, misc
10(null/CFG)unconditional

Binary Tags

[alive, humanoid, held_item, worn, nature, built, magical, tech, small, hostile, edible, ui]

Palette IDs

IDName
0stardew
1starbound
2snes
3nes
4gameboy
5pico8
6endesga

▸ THE COCHRAN BLOCK, LLC · CAGE 1CQ66 · UEI W7X3HAQL9CF9 · UNLICENSE · cochranblock.org