Skip to main content

FlashKAN

Fast B-spline Kolmogorov-Arnold Network layers for PyTorch.

6-15x faster than standard Cox-de Boor implementations (PyKAN, efficient-kan), faster than Gaussian RBF alternatives (FastKAN) — while producing exact B-spline basis values with compact support, C2 continuity, and partition of unity.

How it works

Standard KAN implementations compute B-spline basis functions using the Cox-de Boor recursion — 3 sequential passes for cubic splines, each creating intermediate tensors. FlashKAN replaces this with the truncated power closed form:

N(u) = (1/6) [relu(u)³ - 4·relu(u-1)³ + 6·relu(u-2)³ - 4·relu(u-3)³ + relu(u-4)³]

This single expression computes exact B-spline values with no recursion, no span lookups, and no gather operations. torch.compile fuses all elementwise ops into one GPU kernel.

Installation

pip install flashkan

Requirements: Python >= 3.9, PyTorch >= 2.0

Supported devices: CPU, CUDA (NVIDIA), MPS (Apple Silicon)

From source

git clone https://github.com/NAVEENMN/flashkan.git
cd flashkan
pip install -e .

Quick start

import torch
from flashkan import KANLayer, KANNetwork

# Drop-in replacement for nn.Linear
layer = KANLayer(784, 64)
x = torch.randn(32, 784)
y = layer(x)  # [32, 64]

# Multi-layer network
net = KANNetwork([784, 64, 10])
y = net(torch.randn(32, 784))  # [32, 10]

MNIST example

import torch
import torch.nn as nn
from flashkan import KANNetwork

model = KANNetwork([784, 64, 10])
optimizer = torch.optim.Adam(model.parameters(), lr=1e-3)
criterion = nn.CrossEntropyLoss()

# Standard PyTorch training loop
for images, labels in train_loader:
    output = model(images.view(-1, 784))
    loss = criterion(output, labels)
    optimizer.zero_grad()
    loss.backward()
    optimizer.step()

See examples/ for complete runnable scripts.

API

KANLayer(in_features, out_features, grid_size=5, spline_order=3)

A single KAN layer. Drop-in replacement for nn.Linear.

Parameter Default Description
in_features Input dimension
out_features Output dimension
grid_size 5 Number of knot intervals (more = finer approximation)
spline_order 3 B-spline degree (3 = cubic, recommended)
grid_range (-1, 1) Input range for the spline grid

KANNetwork(layer_dims, grid_size=5, spline_order=3)

Stack of KAN layers.

# 3-layer KAN: 784 -> 128 -> 64 -> 10
net = KANNetwork([784, 128, 64, 10])

Benchmarks

Forward pass time (ms) on Apple M-series GPU (MPS), batch=256:

Layer MNIST (784→64) FashionMNIST (784→64) CIFAR-10 (3072→64)
FlashKAN (compiled) 0.27 0.20 0.39
FastKAN (Gaussian RBF) 0.38 0.31 0.99
NoGather (unrolled) 0.99 1.02 4.85
Vanilla (Cox-de Boor) 1.69 1.67 5.98

FlashKAN is 6.3x faster than vanilla Cox-de Boor on MNIST and 15.3x faster on CIFAR-10.

Why it's fast

91% of a standard KAN forward pass is spent computing B-spline basis functions. FlashKAN eliminates this bottleneck:

Approach Basis cost Why
Cox-de Boor (PyKAN) 3 sequential GPU passes Each pass depends on previous
Gaussian RBF (FastKAN) 1 exp() call Fast but not a true B-spline
Truncated power (FlashKAN) 1 fused kernel clamp + multiply is cheaper than exp()

B-spline properties preserved

Unlike Gaussian RBF approximations, FlashKAN computes exact B-spline basis values:

  • Compact support — each basis function is exactly zero outside its knot span window
  • C2 continuity — second derivatives are continuous at every knot
  • Partition of unity — basis values sum to 1 at every point in the interior
  • Non-negativity — all basis values are >= 0

Verified: max difference vs Cox-de Boor reference is < 5e-5 in float32.

Project structure

src/flashkan/
├── __init__.py     # Public API
├── basis.py        # Truncated power B-spline + torch.compile (core math)
├── layer.py        # KANLayer
└── network.py      # KANNetwork

4 source files. The core innovation is in basis.py — 30 lines of math.

Citation

If you use FlashKAN in your research, please cite:

@software{flashkan2026,
  title={FlashKAN: Fast B-spline KAN Layers via Truncated Power Basis},
  author={Mysore, Naveen},
  year={2026},
  url={https://github.com/NAVEENMN/flashkan}
}

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flashkan-0.2.0.tar.gz (13.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

flashkan-0.2.0-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

Details for the file flashkan-0.2.0.tar.gz.

File metadata

  • Download URL: flashkan-0.2.0.tar.gz
  • Upload date:
  • Size: 13.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for flashkan-0.2.0.tar.gz
Algorithm Hash digest
SHA256 bd277de98fc1b1f7242567f30ba1b2fbd18ed4ad8eac21400ecccca4810729f7
MD5 113e7face2a058cd762ed8f202db1cb6
BLAKE2b-256 cfc4678df85e33009aa979d19ba5dd1fbd4070d0edbda9d99dd33eea745bea97

See more details on using hashes here.

File details

Details for the file flashkan-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: flashkan-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 11.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for flashkan-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d6968b372dec9cf3620081302a7087b4c662738748a34b5fcc018cc8b33a7c2c
MD5 e3b968b4d9c9b5bcb80346e0925a94d9
BLAKE2b-256 5f8d020e175c381e45b25cd0fa0717c3dbb1d3bdc3c28decf7f81e4be33fbb56

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page