mantissa-nn

The shared neural-net base for the mantissa family.

mantissa-nn holds the primitives every other package in the family reuses, so that the specialized packages depend on this base rather than on each other:

• the C-engine binding (mantissa_nn._engine.engine) — loads mantissa once and gates on the dense primitive every model needs;
• the pure-numpy reference backend (mantissa_nn._numpy_backend) — the identical call signatures in numpy, the correctness oracle;
• the fully-connected layers Dense / Flatten and the Layer contract (mantissa_nn.layers).

Datasets are deliberately not here — each package owns and downloads its own, so they stay independent.

Built on top of it:

package	adds
mantissa-cnn	convolution + pooling layers, a CNN model zoo
mantissa-mlp	the tabular training loop + tabular datasets
mantissa-autoencoder	encoder/decoder model + decoder layers

from mantissa_nn import layers
from mantissa_nn._engine import engine     # the shared mantissa.Mantissa

The default compute path is the mantissa C engine (>= 0.2.1); backend="numpy" in the model packages selects the pure-numpy reference implementation.

The mantissa family

Part of the mantissa family: a low-precision engine written in C, with small Python packages built on top. Each package sits under the one it depends on — ⭐ marks where you are, and every other name links to its repo.

• mantissa — low-precision neural-network engine in C (the core)
  • mantissa-perceptron — perceptron & ADALINE, the linear classics
  • ⭐ mantissa-nn — shared neural-net primitives (layers, engine binding) (you are here)
    • mantissa-cnn — convolutional networks for images
      • mantissa-auto-encoder — autoencoders for denoising & super-resolution
      • mantissa-interpret — CNN interpretability (occlusion, saliency, Grad-CAM)
      • mantissa-embed — CNN metric learning (image embeddings for similarity & retrieval)
    • mantissa-mlp — multilayer perceptrons, fully-connected nets

Install

pip install mantissa-nn

For the development layout, clone the family repos as siblings and pip install -e . — a sibling mantissa/ checkout is picked up automatically when mantissa-core is not installed.