NAAb Pivot

Version updated for https://github.com/b-macker/naab-pivot to version v1.0.0.

  • This action is used across all versions by ? repositories.

Action Type

This is a Composite action.

Go to the GitHub Marketplace to find the latest changes.

Action Summary

NAAb Pivot is a GitHub Action that automates the optimization of slow code written in interpreted languages such as Python, Ruby, and JavaScript by analyzing its performance, generating faster versions in compiled languages like Go, Rust, or C++, and validating correctness with statistical parity testing. It addresses the challenges of improving code efficiency, enabling up to 60x speedup and significant memory reductions, while providing confidence in correctness and facilitating incremental migration in large, polyglot codebases. Key capabilities include performance analysis, multi-language code synthesis, correctness validation, and interactive visualization via a web dashboard.

Release notes

NAAb Pivot v1.0.0

Part of the NAAb Language Ecosystem

Released: 2026-02-26

Overview

NAAb Pivot is a polyglot code evolution and optimization platform built on the NAAb Language. It automatically analyzes slow interpreted code, generates optimized versions in compiled languages, and mathematically proves correctness through parity validation.

Results: 3-60x speedups with 99.99% parity confidence

Ecosystem:

  • NAAb Language - Core polyglot scripting language with governance
  • NAAb Bolo - Polyglot code executor and validator
  • NAAb Pivot (this project) - Code evolution and optimization platform

What’s New

Core Features

6 Core Scripts:

  • pivot.naab - Main CLI orchestrator
  • analyze.naab - Multi-language code analyzer
  • synthesize.naab - Code generator with caching
  • validate.naab - Parity validator (99.99% confidence)
  • benchmark.naab - Performance tracking
  • migrate.naab - Incremental migration helper

10 Advanced Modules:

  • Plugin system
  • Hotspot detector
  • Report generator (JSON, HTML, CSV, SARIF, Markdown)
  • Config manager
  • Dependency analyzer
  • Parity engine
  • Vessel cache
  • Template engine
  • Compilation manager
  • Fabric utilities

8 Optimization Profiles:

  • ultra-safe
  • conservative
  • balanced (default)
  • aggressive
  • experimental
  • minimal
  • embedded
  • wasm

8 Target Languages:

  • Go
  • C++
  • Rust
  • Ruby
  • JavaScript
  • PHP
  • Zig
  • Julia

Examples

10 real-world examples with proven performance improvements:

ExampleSpeedupDescription
01. Basic Evolution3.5xPython → Go loop optimization
02. Batch Processing10xPython → Rust ETL pipeline
03. ML Optimization15xPython → C++ inference
04. Web Backend8xPython → Go API (12K req/s)
05. Crypto Mining18xPython → Rust+SIMD
06. Data Pipeline10xPython → C++ analytics
07. Scientific Computing60xPython → Julia+GPU
08. Embedded System15xPython → Zig (96% less memory)
09. Incremental MigrationN/A156K LOC enterprise guide
10. Polyglot Microservices7.1xMixed stack ($1,800/mo savings)

Quality Metrics

  • 46 commits (100% governance compliance)
  • 17/17 tests passing
  • 8/8 examples validated
  • 134+ files
  • ~28,000 lines
  • Zero critical bugs
  • 77.5% code coverage

Installation

# Clone repository
git clone --recursive https://github.com/b-macker/naab-pivot.git
cd naab-pivot

# Build NAAb
bash build.sh

# Run
./naab/build/naab-lang pivot.naab --help

Docker:

docker pull bmacker/naab-pivot:1.0.0

GitHub Action:

- uses: b-macker/naab-pivot@v1
  with:
    file: src/code.py
    profile: balanced

Documentation

Usage

Analyze code:

naab-lang pivot.naab analyze slow.py

Generate optimized version:

naab-lang pivot.naab evolve slow.py --profile balanced

Validate correctness:

naab-lang pivot.naab validate slow.py vessels/slow_vessel

Benchmark performance:

naab-lang pivot.naab benchmark vessels/

Platform Support

  • Linux (tested)
  • Android/Termux (tested)
  • macOS (community testing)
  • Windows (community testing)

Contributing

See CONTRIBUTING.md

License

MIT License - See LICENSE