Repository navigation
Mini 0.6.0
Mini 0.6.0 adds precompiled libraries, Float32 tensors, plotting and WebAssembly library exports, plus an interactive digit classifier in the browser.
Highlights
- Precompiled libraries.
minic-native --emit-mliband--lib, dependency builds through.mlib,mini package, and a precompiled standard library in the release archives. - Float and FloatArray. Real 32-bit floating-point storage and arithmetic, array accessors, boxing and C interop.
mini.tensoruses Float32 tensors with BLAS acceleration where available and a Kotlin fallback. - Tensor and autograd library. Broadcasting, matrix multiplication, automatic differentiation, neural-network layers and optimizers. The tensor and plot libraries are available in the browser toolchain.
- Plotting.
mini.plotprovides pyplot, Axes and Kotlin DSL APIs, SVG figures, subplots, log scales, tooltips and colormaps. Rich display output appears below notebook and playground cells. - WebAssembly libraries. Export supported functions with
@WasmExport, build awasm-libpackage withmini build --target wasm32 --lib, and use the generated JavaScript module and TypeScript declarations. See the WebAssembly library guide. - Digit classifier notebook. Train and compare matrix and
Linearclassifiers, inspect three plot APIs, and try the trained models on drawings. The default experiment is precompiled; successful compilations are cached locally so repeated runs avoid loading the compiler toolchain when possible. - Native development workflow. Compiler unit tests and end-to-end tests run through Mini without Gradle or a JVM.
mini checkchecks all project source files. Kotlin cross-checks remain available separately.
Install
curl -fsSL https://raw.githubusercontent.com/HenrySchwerdt/mini/main/install.sh | sh
mini new hello && cd hello && mini runRelease archives contain mini, minic, the self-hosted compiler, the runtime and the standard library for Linux x64, Linux arm64 and macOS arm64. A portable C bootstrap seed and SHA256SUMS are included. A C compiler is required for native builds; the WebAssembly library target additionally needs a WASI-capable clang and wasm-ld.
Try the digit notebook or read the documentation.
Known gaps
- Windows releases, coroutines and async IO, reflection and JSON support are still planned.
- Strict-mode code generation and the standard library's adoption of the ownership memory model remain in progress.
- The digit experiment downloads a public dataset and needs network access on its first run.
All changes since v0.5.0
- Show checker readiness and serve built assets in cache browser tests (bf5e30a)
- Harden compile cache and cover notebook regressions in CI (1fc4c5c)
- Prepare Mini 0.6.0 release notes and version (49c29a1)
- Cache and precompile playground examples to shorten notebook startup (a0c93e3)
- Compare matrix and Linear classifiers in short notebook cells with three plot APIs (fa613a6)
- Add an interactive digit-training notebook to showcase tensor and plot (2088a6d)
- wasm-lib: guide page, README section, unit tests, CI step (6ddf241)
- wasm-lib: end-to-end tests (Node and Chromium), testdata for @WasmExport (48df896)
- mini: kind wasm-lib, build --target wasm32 --lib, new --template wasm-lib (5a317c5)
- wasm-lib: @WasmExport, reactor module glue (IR wrappers, runtime helpers, .mjs and .d.ts generator) (efb922a)
- wasm: run-wasi.mjs avoids Node's fast API call path (GC crash in path_open under TurboFan wasm) (1349314)
- website: mini.plot page rewritten for the matplotlib-style API, gallery, tensor training curve; check-samples builds libs with alt/ sources (a713202)
- mini.plot: fill_between keeps the line colour, minimal palette, README (ab9b619)
- Float: docs, cinterop_boxing expectation, e2e include paths for the interop C library (ddf6581)
- Unit tests for the API stub writer (c6fd390)
- mini.plot: matplotlib-style API (plt, Axes, Figure, subplots), modern themes, log scale, tooltips, colormaps (db645e0)
- Stable names for overloads that differ in type arguments; relative stub paths; docs (6127c6b)
- mini.tensor: Float32 tensors on FloatArray, sgemm/sgemv/sdot; FloatArray C interop test (d43bfa9)
- Real Float/FloatArray: MkFloatArray runtime, inlined accessors, boxed Float, floatArrayOf, tests (c8ca3b2)
- mlib documentation and tests (e7449cb)
- stdlib.mlib by default; mini builds dependencies to .mlib, mini package (7af60c6)
- compiler: support ++ and -- on indexed elements (a[i]++, --a[i]) (6fa8cea)
- Precompiled libraries: minic-native --emit-mlib / --lib (95bb9b9)
- mini.tensor: examples, benchmark, README, faster Kotlin matmul kernel (17f8f83)
- mini.tensor: tensors, broadcasting, matmul (BLAS via dlopen with Kotlin fallback), autograd, nn, optim (24b108b)
- mini.plot README, display protocol spec, e2e for figures in light/dark and mobile (2a1d596)
- Preinstalled libraries in the browser toolchain (libs.json), Libraries docs section, mini.plot and display pages, CI checks for display bundles (1a3136c)
- stdlib: kotlin.math floating point functions (sqrt, exp, ln, pow, trig, PI, E, ...) bound to libm (37765e6)
- mini check checks every source file (bc7b8bc)
- mini --version shows the toolchain version (5e4f2c9)
- website: render rich display bundles below cells (notebook, playground, docs cells) (6f69baf)
- mini.plot: SVG plotting library (line, scatter, bar, histogram, heatmap) with tests (0adbe36)
- Explain mini and minic installation workflows for the native toolchain (22e4f3d)
- stdlib: mini.display, the rich output bundle (display protocol) (8797e26)
- Improve shared Kotlin editor indentation, completion and keyboard tools (3db4236)
- Keep demo title bar inside the code window frame (d868adc)
- Expand Learn into a 26-chapter Kotlin and Mini course (7fd347c)
- Docs, k2-oracle workflow and README, explain generator, workflows without Gradle (4e818d2)
- Website scripts, benchmarks and release workflow use the native compiler (0bb20c9)
- wasm scripts use the native compiler (no JVM minic emit-mir, no native-driver) (5d2111b)
- Native ./minic wrapper, merge fixes, DiagFormatTest on mini test (fa8a94f)
- tools/k2-oracle: separate Gradle build for the K2 cross-checks; native CI shards (01aad95)
- Native end-to-end runner for compiler/testdata (scripts/test-e2e.sh) (9d76214)
- Port native-driver and mini-tool tests to mini test (a74c788)
- Turn Learn into a guided Kotlin notebook and fix documentation sidebar layout (958d345)
- Port backend and frontend tests to mini test; class-based tests, mini.io directory API, purity script (e421596)
- Flat Mini project layout for the compiler, native bootstrap (4e7a003)