# nx_vulkan v0.1.0 - Table of Contents

GPU tensor backend for Nx via Vulkan compute. Pure-Rust path (vulkano) plus C++ spirit path. Validated on Axon training, Scholar linear regression, and the eXMC NUTS sampler. Works on Linux + FreeBSD NVIDIA where CUDA does not exist.

## Pages

- [Nx.Vulkan](readme.md)
- [Changelog](changelog.md)
- [Nx.Vulkan.VulkanoBackend — Roadmap](vulkano_backend_roadmap.md)

## Modules

- [Nx.Vulkan](Nx.Vulkan.md): Nx tensor backend on Vulkan compute.
- [Nx.Vulkan.Backend](Nx.Vulkan.Backend.md): `Nx.Backend` implementation on top of the Vulkan compute primitives.
- [Nx.Vulkan.ChainShaderSpecs](Nx.Vulkan.ChainShaderSpecs.md): Catalog of family specs for templated chain-shader synthesis.
- [Nx.Vulkan.Compiler](Nx.Vulkan.Compiler.md): Path A.2 v2 (partial) — `Nx.Defn.Compiler` that auto-detects fusable
elementwise chains and dispatches `Nx.Vulkan.fused_chain/3` instead
of N separate shader calls.
- [Nx.Vulkan.Fast](Nx.Vulkan.Fast.md): Named fused kernels for MCMC hot paths.
- [Nx.Vulkan.Fuse](Nx.Vulkan.Fuse.md): Path A.2 — compile-time fusion of elementwise op chains.
- [Nx.Vulkan.Native](Nx.Vulkan.Native.md): Rustler NIF bindings for the Vulkan compute backend.
- [Nx.Vulkan.NativeV](Nx.Vulkan.NativeV.md): Rustler NIF for the pure-Rust (vulkano) compute backend.
- [Nx.Vulkan.Node](Nx.Vulkan.Node.md): Long-lived per-machine GPU node. A named `GenServer` that owns the
spirit `VkPipelineCache`, the persistent buffer registry, and the
watchdog/timeout layer. Clients submit work via `with_node/2` (or
the lower-level `exec/2`); the node serializes execution and
reports timeouts/dead-server/etc. as error tuples.
- [Nx.Vulkan.PipelineCache](Nx.Vulkan.PipelineCache.md): Phase 2 W5 — disk persistence for spirit's `VkPipelineCache`.
- [Nx.Vulkan.ShaderTemplate](Nx.Vulkan.ShaderTemplate.md): Phase 1 — templated GLSL shader synthesis.
- [Nx.Vulkan.ShaderTemplate.FamilySpec](Nx.Vulkan.ShaderTemplate.FamilySpec.md): Per-family hooks for the templated chain shader.
- [Nx.Vulkan.Synthesis](Nx.Vulkan.Synthesis.md): Phase 1 — end-to-end shader synthesis driver.
- [Nx.Vulkan.VulkanoBackend](Nx.Vulkan.VulkanoBackend.md): Pure-Rust (vulkano) `Nx.Backend` implementation. Sibling of
`Nx.Vulkan.Backend` (C++ spirit-backed); same compute fabric,
different memory-management story.