Autonumba is an aggressive auto-JIT tool that scans Python code and injects @njit wherever it safely can, with optional ahead-of-time (AOT) compilation into native binaries.
- ⚡ Automatic JIT and AOT compilation for instant native speed
- 📂 Boost folders, single files, or installed libraries
- 🏷️
@libnamesyntax for installed site-packages - ❌
exclude.txtsupport for skipping files - ⚙️ Configurable Numba flags for cache, fastmath, parallel, nogil, boundscheck
- 🖥️ CLI-first, fast, clean workflow
- 🛑 Supports
#nonumbacomment to skip functions from JIT injection
pip install autonumbaor from source:
git clone https://github.com/pro-grammer-SD/autonumba.git
cd autonumba
python -m pip install --user .or use the prebuilt binary in bin/ (bin/autonumba.exe)
Boost a folder:
python -m autonumba src -c -f -p -n -bBoost a single file:
python -m autonumba main.py -c -fBoost an installed library:
python -m autonumba @mylib -c -f -pModify files in-place:
python -m autonumba src -i -c -f -p -n -bEnable ahead-of-time compilation:
python -m autonumba src --aotDisable Rich output (for Windows encoding issues):
python -m autonumba src -nrNuitka compile to EXE after boost:
python -m autonumba main.py -cm| Flag | Description |
|---|---|
| -i, --inplace | ✏️ Modify files in place |
| -c, --cache | 💾 Enable njit cache |
| -f, --fastmath | ⚡ Enable fastmath |
| -p, --parallel | 🔀 Enable parallel loops |
| -n, --nogil | 🛠 Release GIL |
| -b, --boundscheck | 📏 Enable bounds checking |
| --aot | 🚀 Force ahead-of-time compilation into binaries |
| -cm, --compile | 🖥 Nuitka compile to EXE after boost |
| -nr, --no-rich | ❌ Disable rich output / emojis |
Flags are enabled by default. Pass flags to selectively override defaults.
- Designed for numeric-heavy code.
- Dynamic Python features (strings, IO, objects) may not compile correctly.
- Use responsibly. Native binaries are fast but can break dynamic behavior.
- Functions with
#nonumbacomment on the definition line will be skipped from JIT injection.
