Skip to main content

Alnoms: Sovereign Algorithm Standard and Performance Governance Engine

Project description

Alnoms

Industrial-grade algorithms, performance profilers, and data structures for Python.

Built by Arprax Lab, this toolkit is designed for the "Applied Data Intelligence" era—where understanding how code scales is as important as the code itself.


🚀 Features

  • ArpraxProfiler: High-precision analysis with GC control, warmup cycles, and OHPV2 (Doubling Test) complexity estimation.
  • Industrial Utils: High-performance data factories (random_array, sorted_array) for robust benchmarking.
  • Standard Library: High-performance implementations of classic algorithms (Merge Sort, Bubble Sort, etc.) with strict type hinting.

📦 Installation

PyPI version

# Core only
pip install alnoms

# With visual tools
pip install alnoms[visuals]

# With research tools
pip install alnoms[research]

🔬 Quick Start: Benchmarking

Once installed, you can immediately run a performance battle between algorithms.

from alnoms import Profiler
from alnoms.utils import random_array  # Clean import from your new 'utils'
from alnoms.algorithms import merge_sort # Using the 'lifted' API

# 1. Initialize the industrial profiler
profiler = Profiler(mode="min", repeats=5)

# 2. Run a doubling test (OHPV2 Analysis)
results = profiler.run_doubling_test(
    merge_sort,
    random_array,
    start_n=500,
    rounds=5
)

# 3. Print the performance analysis
profiler.print_analysis("Merge Sort", results)

🎓 Demonstrations & Pedagogy

We provide high-fidelity demonstrations to show the library in action. These are located in the examples/ directory to maintain a decoupled, industrial-grade production environment.

Performance Profiling

Measure execution time, memory usage, and operation counts across different input sizes ($N$):

python examples/demo_profiler.py

Algorithm Visualization

View real-time, frame-by-frame animations of sorting and search logic:

python examples/visualizer.py

[!TIP] For detailed instructions on running these demos and setting up the visualization environment, see our Examples Guide.

🏗️ The Alnoms Philosophy

Applied Data Intelligence requires more than just code—it requires proof.

  • Zero-Magic: Every algorithm is written for clarity and performance. We don't hide logic behind obscure abstractions or hidden standard library calls.
  • Empirical Evidence: We don't just guess Big O complexity; we measure it using high-resolution timers and controlled environments.
  • Industrial Scale: Our tools are designed to filter out background CPU noise, providing reliable benchmarks for real-world software engineering.

📚 Citation

To cite the Software: See the "Cite this repository" button on our GitHub.

To cite the Handbook (Documentation):

@manual{alnoms_handbook,
  title        = {The Algorithm Engineering Handbook},
  author       = {Chowdhury, Tanmoy},
  organization = {Arprax LLC},
  year         = {2026},
  url          = {https://alnoms.com/book},
  note         = {Accessed: 2026-02-01}
}

© 2026 Arprax Lab A core division of Arprax dedicated to Applied Data Intelligence.

Project details


Download files

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

Source Distribution

alnoms-0.4.7.tar.gz (37.1 kB view details)

Uploaded Source

Built Distribution

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

alnoms-0.4.7-py3-none-any.whl (44.7 kB view details)

Uploaded Python 3

File details

Details for the file alnoms-0.4.7.tar.gz.

File metadata

  • Download URL: alnoms-0.4.7.tar.gz
  • Upload date:
  • Size: 37.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for alnoms-0.4.7.tar.gz
Algorithm Hash digest
SHA256 6e0087afcc7865d28e5e5d5da052567e0dc9de5e9a66a2a7ee1f6d502fcdf01b
MD5 225f2241fc1d5b7b1cd71848d07987c9
BLAKE2b-256 4db9b923412b7892b89156dc325f13e711063aa04e82948023072b03c40c9ad8

See more details on using hashes here.

File details

Details for the file alnoms-0.4.7-py3-none-any.whl.

File metadata

  • Download URL: alnoms-0.4.7-py3-none-any.whl
  • Upload date:
  • Size: 44.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for alnoms-0.4.7-py3-none-any.whl
Algorithm Hash digest
SHA256 2204a64c24df6b79fbed62f3c5dd86cb6cc55c7671e384fae324348470f7877c
MD5 cdd3e989f9a4d921aefef2f3f60f1ca5
BLAKE2b-256 d5b8fe83dae8d202217319a5359c4f4bd5d2d98ce088ed95473b2f17f8f8367b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page