Index

Table of contents

One chapter per Welvet feature. Each page: why, what, status, and a Go example.

I · Orientation

• 1What Welvet is
  ✅ engine · github.com/openfluke/welvet
• 2Repository map
  ✅ layout

II · Foundation

• 3core — types & backends
  ✅ · github.com/openfluke/welvet/core
• 4weights — FormatNone MatVec
  ✅ · github.com/openfluke/welvet/weights
• 5quant — 20 pack formats
  ✅ · github.com/openfluke/welvet/quant
• 6simd — Plan 9 kernels
  ✅ · github.com/openfluke/welvet/simd
• 7webgpu — device GEMV & shaders
  ✅ · github.com/openfluke/welvet/webgpu
• 8tiling — SC/MC & workgroups
  ✅ · github.com/openfluke/welvet/tiling
• 9architecture — volumetric grid
  ✅ · github.com/openfluke/welvet/architecture
• 10fusedgpu — decoder on device
  ✅ · github.com/openfluke/welvet/fusedgpu

III · Layers

• 11layers/dense — MatVec microkernel
  ✅ · github.com/openfluke/welvet/layers/dense
• 12layers/mha — attention
  ✅ · github.com/openfluke/welvet/layers/mha
• 13layers/swiglu — gated FFN
  ✅ · github.com/openfluke/welvet/layers/swiglu
• 14layers/rmsnorm
  ✅ · github.com/openfluke/welvet/layers/rmsnorm
• 15layers/layernorm
  ✅ · github.com/openfluke/welvet/layers/layernorm
• 16layers/embedding
  ✅ · github.com/openfluke/welvet/layers/embedding
• 17layers/softmax
  ✅ · github.com/openfluke/welvet/layers/softmax
• 18layers/sequential
  ✅ · github.com/openfluke/welvet/layers/sequential
• 19layers/residual
  ✅ · github.com/openfluke/welvet/layers/residual
• 20layers/cnn1 · cnn2 · cnn3
  ✅ · github.com/openfluke/welvet/layers/cnn2
• 21layers/rnn · lstm
  ✅ · github.com/openfluke/welvet/layers/lstm
• 22layers/seqmix — mixer contract
  ✅ · github.com/openfluke/welvet/layers/seqmix
• 23layers/gdn — gated delta net
  🚧 · github.com/openfluke/welvet/layers/gdn
• 24layers/mamba — selective SSM
  🚧 · github.com/openfluke/welvet/layers/mamba
• 25layers/convt1 · convt2 · convt3
  🚧 · github.com/openfluke/welvet/layers/convt1
• 26layers/kmeans
  🚧 · github.com/openfluke/welvet/layers/kmeans
• 27layers/parallel — MoE combine
  🚧 · github.com/openfluke/welvet/layers/parallel
• 28layers/metacognition
  🚧 · github.com/openfluke/welvet/layers/metacognition

IV · Runtime

• 29runtime/forward
  ✅ · github.com/openfluke/welvet/runtime/forward
• 30runtime/backward
  ✅ · github.com/openfluke/welvet/runtime/backward
• 31runtime/training
  ✅ · github.com/openfluke/welvet/runtime/training
• 32runtime/step — step mesh
  ✅ · github.com/openfluke/welvet/runtime/step

V · Systems

• 33systems/dna
  ✅ · github.com/openfluke/welvet/systems/dna
• 34systems/evolution
  ✅ · github.com/openfluke/welvet/systems/evolution
• 35systems/tween
  ✅ · github.com/openfluke/welvet/systems/tween
• 36systems/tanhi — UDP HUD
  ✅ · github.com/openfluke/welvet/systems/tanhi
• 37systems/telemetry
  ✅ · github.com/openfluke/welvet/systems/telemetry

VI · Model IO

• 38model/entity — .entity files
  ✅ · github.com/openfluke/welvet/model/entity
• 39model/hf — snapshots
  ✅ · github.com/openfluke/welvet/model/hf
• 40model/tokenizer
  ✅ · github.com/openfluke/welvet/model/tokenizer
• 41model/sampling
  ✅ · github.com/openfluke/welvet/model/sampling
• 42model/transformer — generate
  ✅ · github.com/openfluke/welvet/model/transformer

VII · Apps

• 43apps — octo · flux2 · mosstts
  🚧 · github.com/openfluke/welvet/apps/…
• 44Octo — model shell
  ✅ runs · github.com/openfluke/welvet/apps/octo

VIII · Stubs

• 45stub/seed
  🚧 · github.com/openfluke/welvet/stub/seed
• 46stub/serialization
  🚧 · github.com/openfluke/welvet/stub/serialization
• 47stub/memory
  🚧 · github.com/openfluke/welvet/stub/memory
• 48stub/donate
  🚧 · github.com/openfluke/welvet/stub/donate
• 49stub/fountain
  🚧 · github.com/openfluke/welvet/stub/fountain
• 50stub/hardware
  🚧 · github.com/openfluke/welvet/stub/hardware
• 51stub/accel — NPU/Metal/QNN
  ⬜ · github.com/openfluke/welvet/stub/accel
• 52stub/clustering
  🚧 · github.com/openfluke/welvet/stub/clustering
• 53stub/ensemble
  🚧 · github.com/openfluke/welvet/stub/ensemble
• 54stub/evaluation
  🚧 · github.com/openfluke/welvet/stub/evaluation
• 55stub/grafting
  🚧 · github.com/openfluke/welvet/stub/grafting
• 56stub/grouping
  🚧 · github.com/openfluke/welvet/stub/grouping
• 57stub/introspection
  🚧 · github.com/openfluke/welvet/stub/introspection
• 58stub/observer
  🚧 · github.com/openfluke/welvet/stub/observer
• 59stub/pipeline
  🚧 · github.com/openfluke/welvet/stub/pipeline
• 60stub/templates
  🚧 · github.com/openfluke/welvet/stub/templates
• 61stub/universal
  🚧 · github.com/openfluke/welvet/stub/universal

IX · Validate

• 62w2a — validation harness
  🚧 harness · github.com/openfluke/w2a
• 63Validation report — full suite
  ✅ 137k cells · github.com/openfluke/w2a
• 64Scorecard → v1.0
  v0.76