bunsen - tackling tomorrow's burn problems today!
by ZSpaceLabs
The burn team is working hard to give us a stable long term foundation for developing high-performance and maintainable tensor programming in Rust; The "in Rust" aspect requires a degree of type and runtime R&D research and that requires a conservative posture to api extension.
bunsen provides a "batteries included" complementary community standard library
for research extensions to burn; ideas which are useful enough
to collect into one place, document, and build upon; but front-run
the burn interface frontier.
Every idea in bunsen seeks to either be refined and ported into burn,
or supplanted by the eventual burn solution to that problem.
- The bunsen book explains how bunsen is organized, the systems that cut across it, and how it is developed. Start with Installing and first use.
- The API docs document every type and lifecycle, with worked examples, and list the crate's features.
Kits
A kit is a whole model or simulation, with its configs and, for a model, the weights it loads by name (Kits):
images::resnet: ResNet image classifiers, with torchvision's andtimm's checkpoints by name.images::swin::v2: Swin Transformer V2 image classifiers, without pretrained weights.gpts::nanochat: a port of karpathy's nanochat GPT, and the corpus it trains on. Work in progress.sims::conway: Conway's Game of Life on toroidal 2D and 3D boards.sims::lbm: a D2Q9 lattice-Boltzmann fluid.speech::whisper: OpenAI's Whisper, with a pretrained index, decoders, and a stream driver.speech::silero_vad: the Silero voice-activity detector, with weights a build can bundle.tokens: not a model; the ids-to-text seam the model kits share.
The workspace
Most users depend on bunsen alone. The bunsen repository also publishes its
companion crates (the firehose data pipeline, a Parquet-to-tokens data loader, the shape-contract macro, and bundled
model assets), and holds the development, validation, and example crates.
The workspace describes each one.
Examples
The repository's examples/ directory holds runnable
programs, one or more per kit or system. The book's
Examples page says what each one shows.
License
bunsen is distributed under the terms of both the MIT license and the Apache License (Version 2.0).