Fucina Reference¶
The detailed reference for the Fucina library: the public API surface, its exact semantics, and the internal layers needed to extend it. Structure and rationale live in ARCHITECTURE.md; this document is the API-level companion. Every Zig snippet is machine-verified against the tree (see §1).
Chapters¶
- Introduction and mental model
- Toolchain, build, and project wiring
- Tensors: types, construction, and data access
- Tensor operations
- Automatic differentiation
- The execution runtime: ExecContext and the memory model
- Named axes: the tag algebra
- Data types, storage, and the raw tensor layer (internal)
- Backends: CPU SIMD, BLAS, threading, and GPU offload
- Quantization
- Training: optimizers, evolution strategies, LoRA, and checkpoints
- Model I/O: GGUF and safetensors
- The LLM stack (fucina_llm)
- Model families and example applications