Chapter 1

What Welvet is

github.com/openfluke/welvet✅ engine

Why it exists

Loom’s flat poly/ package hit import-cycle and honesty walls (QAT morph, silent fallbacks, god-layer). Welvet is the rewrite: one feature per folder, storage-truth dtypes/quants, Dense as the shared MatVec microkernel, tests only in w2a, apps only in apps/.

What it is

An AI engine in Go: layers, 34 dtypes, 20 quant formats, and three backends (CPU tiled · Plan 9 SIMD · WebGPU). Version tracks a 100-point scorecard (today v0.76).

Rules
  1. No tests in engine packages          → w2a/
  2. No silent fallbacks                  → hard error
  3. No hardcoded float32                 → Tensor[T]
  4. No QAT                               → DType + Format = truth
  5. One feature → one folder
  6. v1.0 = scorecard 100/100

Origin

Samuel Watson

Samuel Watson created OpenFluke after intensive T-ALL treatment (post-2018), from a simple frustration: AI tooling was heavy, opaque, and not portable enough to move models cleanly across operating systems or personal devices. Setting up GPU paths often meant large, brittle installs before experimentation could even begin.

That gap drove a long detour through cybersecurity, MBA, and psychology before returning through applied AI study - and finding that most paths still taught framework usage more than system construction. The result was a build journey across planetbridging into OpenFluke projects, from paragon and loom to Welvet.

The early breakthroughs were practical and hard-won: first dense nets in Go, then WebGPU proof points (for example iso-demo v0.1.0), then repeated cycles of speed, layers, 3D, tiling, SIMD, and bit-oriented model paths for personal intelligence.

Why "OpenFluke": open source values plus a life-saving fluke blood test that caught cancer early.
Why "Welvet": a name shaped in gaming sessions with family.

I wish this tool existed in 2018 to keep trying things in AI and asking "what if I try this?" - and maybe help deterministic medical deployment of AI models.

"Our duty, as soldiers, is to protect humanity. Whatever the cost." - Master Chief

package main

import (
	"fmt"

	"github.com/openfluke/welvet/core"
	"github.com/openfluke/welvet/layers/dense"
)

func main() {
	l, err := dense.New(8, 4, core.ActivationReLU, core.DTypeFloat32)
	if err != nil {
		panic(err)
	}
	l.Exec.Backend = core.BackendCPUTiled

	x := core.NewTensor[float32](1, 8)
	for i := range x.Data {
		x.Data[i] = float32(i) * 0.1
	}
	pre, post, err := dense.Forward(l, x)
	if err != nil {
		panic(err)
	}
	fmt.Println("pre", len(pre.Data), "post", len(post.Data))
}

pre 4 post 4

cd welvet && go build ./...
cd w2a && go test ./tests/dense -v