Skip to main content

npmai-fast

Zero-dependency AST-to-native compiler for hot numeric Python functions.

from npmai_fast import optimize

@optimize
def total(a: int, b: int) -> int:
    result = 0
    for i in range(a):
        result += b
    return result

Just decorate and call. No config, no build step you have to run yourself.

What actually happens

On first call, the function's source is analyzed. If it fits the compilable numeric subset (int/float params and return, arithmetic, comparisons, if/while/for-range loops — see below), it is transpiled to C++20, compiled once with whatever compiler is on your machine (g++, clang++, or MSVC), cached in ~/.cache/npmai_fast/, and called natively through ctypes on every call after that.

If the function does not fit that subset (dicts, lists, generators, closures, exceptions, dynamic typing, etc.) — or no C++ compiler is installed — it transparently falls back to plain CPython. Same result, just not accelerated. This is by design: correctness first, speed second.

Supported today

  • Parameters and return value annotated int or float
  • + - * / // % ** (with correct Python floor-division/modulo semantics)
  • Comparisons, and/or/not
  • if/elif/else, while, for x in range(...)
  • Single-name local variables (no re-typing a variable mid-function)

Not yet supported (falls back automatically, does not error)

  • Lists, dicts, strings, objects, classes
  • Function calls to anything other than range()
  • Exceptions, generators, closures over outer state
  • *args/**kwargs, default arguments

This puts npmai-fast in the same category as Numba's @njit or Pythran — a numeric hot-loop compiler, not a general Python-to-native compiler. The difference is a zero-dependency implementation (no LLVM) plus AST-level inlining planned for a future release.

CLI

npmai-fast check   # is a C++ compiler available on this machine?
npmai-fast stats   # cache size / compiled function count
npmai-fast clear   # wipe the compiled-function cache

Requirements

A C++20-capable compiler must be installed for acceleration to kick in:

  • Linux: sudo apt install g++ (or your distro's equivalent)
  • macOS: xcode-select --install
  • Windows: Visual Studio Build Tools, "Desktop development with C++"

Without one, functions still run correctly — just as plain Python.

Metadata

Release files for npmai-fast 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for npmai-fast 1.0.0
File Size Uploaded Provenance Actions
npmai_fast-1.0.0.tar.gz 10.6 kB Without provenance Details for npmai_fast-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for npmai-fast 1.0.0
File Interpreter ABI Platform Actions
npmai_fast-1.0.0-py3-none-any.whl Python 3 none any Details for npmai_fast-1.0.0-py3-none-any.whl

Total release size: 22.4 kB

Release files / npmai_fast-1.0.0.tar.gz

Download URL npmai_fast-1.0.0.tar.gz
Size 10.6 kB
Tags Source
SHA-256 checksum
How to use checksums
8d8fee80761fcd7af3a08ebd5373cc66f3da840b7d286a76f876448c579e61e7
BLAKE2b-256 checksum
How to use checksums
ce32d2dbb0d3fefbf50daaaf87e06b52cfbc9bea91bfd7d088e23a49ff3f1bce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / npmai_fast-1.0.0-py3-none-any.whl

Download URL npmai_fast-1.0.0-py3-none-any.whl
Size 11.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fb24c35875c68b80e6162b72b4f8b64793c6b6060d11c15fadb7ed08a142d23b
BLAKE2b-256 checksum
How to use checksums
b6863654df3fd9e233bccd2689b3099921e00f47edb0b0c75e6ff2e6380d228c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for npmai-fast 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

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