ruv-FANN
Neural networks and weight-space programming in Rust, JavaScript and WebAssembly. Inspect activations, edit weights, evaluate candidates, train small models, an
What is ruv-FANN?
Neural networks and weight-space programming in Rust, JavaScript and WebAssembly. Inspect activations, edit weights, evaluate candidates, train small models, and explicitly promote or roll back revisions.
Overview of ruv-FANN
What it is
ruv-FANN is a set of packages for building, training, and inspecting small neural networks in Rust, JavaScript, TypeScript, and WebAssembly. It introduces weight-space programming (WSP), a method for directly editing model weights as proposals that must be evaluated before promotion or rollback. The repository also includes separate projects for forecasting, agent systems, GPU compute, and image processing.
Key features
- Weight-space programming: propose direct weight edits, compare candidates against baselines, and explicitly promote or roll back revisions.
- Multiple language support: Rust core crate, JavaScript/TypeScript npm packages, and WebAssembly bindings.
- Inspection and tracing: inspect activations, trace model dimensions, and analyze weight sensitivity.
- Bounded search and evaluation: bounded patches, holdout gates, invariants, and finite-domain checks.
- Safetensors checkpoint editing: standalone Rust library and CLI for bounded F32, F16, and BF16 edits with hash verification.
- Ecosystem integrations: optional Candle CPU linear layers, napi-rs native Node inference, RuVector search, and MetaHarness tuning.
Use cases
- Inspecting activations and testing direct weight patches in Node.js or a browser.
- Training small neural networks and adding weight editing, model memory, or deployment adapters.
- Running prepared inference or dense training in native Rust.
- Editing Safetensors checkpoints offline with bounded replacements and rollback receipts.
- Comparing training gradients, SGD, and AdamW with Candle.
Getting started
For JavaScript/TypeScript weight-space programming, install the published npm package:shnpm install ruv-fann-wspFor Rust, start with the ruv-fann crate. For the Safetensors checkpoint CLI, install with:shcargo install ruv-fann-wsp-tensor --version 0.1.0 --lockedSee the repository README for detailed guides on each package.
License and pricing
Licensed under MIT. Open source.
Based on the project's public README and repository metadata.