hypernix 0.70.2__tar.gz → 0.70.4__tar.gz

{hypernix-0.70.2 → hypernix-0.70.4}/.github/workflows/deploy-docs.yml

@@ -10,11 +10,21 @@ on:
       - 'docs/**'
       - '.github/workflows/deploy-docs.yml'
   workflow_dispatch:
+  workflow_run:
+    workflows: ["pages-build-deployment"]
+    types:
+      - completed
+    branches:
+      - main
+  schedule:
+    # Runs at 00:05 UTC every day for auto-updating content
+    - cron: '5 0 * * *'
 
 permissions:
   contents: read
   pages: write
   id-token: write
+  actions: read
 
 concurrency:
   group: "pages"

{hypernix-0.70.2 → hypernix-0.70.4}/.github/workflows/public-release.yml

@@ -66,8 +66,10 @@ jobs:
       - name: Validate version format
         run: |
           v='${{ inputs.version }}'
-          if ! [[ "$v" =~ ^[0-9]+\.[0-9]+\.[0-9]+([.-]?(rc|pre|alpha|beta|a|b)[0-9]*)?$ ]]; then
-            echo "::error::version '$v' is not PEP 440-ish (e.g. 0.2.0, 0.2.0-rc1, 0.2.0a2)"
+          # PEP 440 allows: N.N.N, N.N.NaN, N.N.NbN, N.N.NrcN, N.N.N.postN, N.N.N.devN
+          # We map 'postr' to '.post' for PEP 440 compliance during build
+          if ! [[ "$v" =~ ^[0-9]+\.[0-9]+\.[0-9]+([._-]?(rc|pre|alpha|beta|a|b|post|postr|dev)[0-9]*)?$ ]]; then
+            echo "::error::version '$v' is not PEP 440-ish (e.g. 0.2.0, 0.2.0-rc1, 0.2.0a2, 0.2.0postr1)"
             exit 1
           fi
 
@@ -76,7 +78,8 @@ jobs:
         run: |
           v='${{ inputs.version }}'
           tag="v$v"
-          if [[ "$v" =~ (rc|pre|alpha|beta|a|b)[0-9]*$ ]]; then
+          # Treat postr as a post-release (prerelease for PyPI purposes)
+          if [[ "$v" =~ (rc|pre|alpha|beta|a|b|postr)[0-9]*$ ]]; then
             echo "prerelease=true"  >> "$GITHUB_OUTPUT"
             echo "::notice::$tag is a prerelease (-> TestPyPI)"
           else
@@ -114,17 +117,20 @@ jobs:
       - name: Bump versions in source
         run: |
           v='${{ inputs.version }}'
+          # Convert postr to PEP 440 compliant .post format for pyproject.toml
+          pep440_v=$(echo "$v" | sed 's/postr/.post/g')
           python - <<PY
           import re
           from pathlib import Path
 
           v = "${{ inputs.version }}"
+          pep440_v = "$pep440_v"
 
           p = Path("pyproject.toml")
-          p.write_text(re.sub(r'^version = "[^"]+"', f'version = "{v}"', p.read_text(), count=1, flags=re.M))
+          p.write_text(re.sub(r'^version = "[^"]+"', f'version = "{pep440_v}"', p.read_text(), count=1, flags=re.M))
 
           s = Path("setup.cfg")
-          s.write_text(re.sub(r'^version = .+$', f'version = {v}', s.read_text(), count=1, flags=re.M))
+          s.write_text(re.sub(r'^version = .+$', f'version = {pep440_v}', s.read_text(), count=1, flags=re.M))
 
           init = Path("src/hypernix/__init__.py")
           init.write_text(re.sub(r'__version__ = "[^"]+"', f'__version__ = "{v}"', init.read_text(), count=1))

{hypernix-0.70.2 → hypernix-0.70.4}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: hypernix
-Version: 0.70.2
+Version: 0.70.4
 Summary: Download and quantize the HyperNix PyTorch model to GGUF (fp32/fp16/Q8_0/Q6_K/Q4_K_M).
 Home-page: https://github.com/minerofthesoal/hypernix-pip
 Author: HyperNix contributors
 License: Apache-2.0
-Project-URL: Homepage, https://huggingface.co/ray0rf1re/hyper-Nix.2
+Project-URL: Homepage, https://minerofthesoal.github.io/HyperNix-pip/
 Project-URL: Source, https://github.com/minerofthesoal/hypernix-pip
 Project-URL: Issues, https://github.com/minerofthesoal/hypernix-pip/issues
 Project-URL: Logo, https://raw.githubusercontent.com/minerofthesoal/hypernix-pip/main/assets/logo.png
@@ -97,10 +97,12 @@ quantize, and ship.
 | `hypernix.pepper_shaker` | 3-tier sharp perturbations: `SmallShaker` (MLM-style mask) / `Dish` (typos) / `TallHandmade` (negation). |
 | `hypernix.pressure_cooker` | Custom AdamW optimizer in 5 tiers: base `PressureCooker` + CPU (`StovetopCooker`, `ElectricCooker`) + GPU (`InductionCooker`, `ProCooker`) + `universal_cooker` selector. Grad accumulation, GradScaler integration, fused/foreach AdamW, optional CUDA-graph capture on Pro. v0.70.0 V2 rewrite adds quantization-aware training (fp16/bf16/fp64 mixed-precision, QAT hooks for Q8/Q6/Q5.5/Q4M), gradient checkpointing, adaptive clipping, EMA shadowing, distributed awareness, dynamic loss scaling, parameter freezing callbacks, LR finder, and tvtop metrics streaming. |
 | `hypernix.pressure_cooker_v3` | ZeRO-optimized V3 optimizer with FP8 support. New `QuantDtype` enum (FP8/FP16/FP32/FP64/Q8/Q6/Q5_5/Q4M) and `QuantConfig` dataclass. `PressureCookerV3` class with ZeRO-1/2 support, improved memory efficiency, and heavily tested quantization paths. `PressureCookerV3Plus` adds full QAT with calibration. |
-| `hypernix.abbicus` | Automatic token regulation and curriculum tuning. Dynamically modifies max sequence length and padding/truncation during training based on model size (0.5B–72B), context length, dataset complexity, and global step. Configurable curriculum steps, dynamic padding, and dataset-type awareness (math/code get 8-aligned padding). |
+| `hypernix.abbicus` | Automatic token regulation and curriculum tuning. **`Abbicus`** (linear) dynamically modifies max sequence length based on model size (0.5B–72B), global step, and dataset type. **`TurboAbbicus`** (v0.70.4) grows context exponentially to a configurable `hard_cap`, then oscillates using a sine wave adjusted by CPU load (never GPU). Includes VRAM safeguard that scales back context when memory is tight. |
+| `hypernix.qa` | *(v0.70.4)* **`QAProcessor`** — turns structured datasets (JSONL, `list[dict]`, plain text) into causal LM training strings. Two modes: `question_answer` (`Question: {q}\nAnswer: {a}`) and `predict_next` (concatenation). Optional `salt_shaker` / `pepper_shaker` seasoning applied *before* templating so template keywords are never corrupted. |
+| `hypernix.stml` | *(v0.70.4)* **Short Term Memory Loss** — two tools. `calculate_vram_context(vram_gb, params, batch_size, precision)` estimates the max safe trained context given your hardware. `STML` context manager enforces an `untrained_max_context` hard cap and folds long sequences into `(batch × segments, segment_length)` chunks so the model trains on all the data. Integrates with Abbicus / TurboAbbicus. CLI: `hypernix stml --vram 24 --params 7`. |
 | `hypernix.compute_framework` | Hardware-agnostic multi-device training. Abstracts CUDA, MPS, CPU, TPU backends with automatic DDP/ZeRO wrapping. `ComputeFramework` handles PyTorch DDP initialization, device placement, fallback logic. Supports `local_rank`, `world_size`, `use_ddp`, `use_fsdp`, `zero_stage`. Auto-detects backend and sets up device. |
 | `hypernix.workshop` | Model frameworks and TTS/ASR pipelines. `WorkshopFramework` base class with `FrameworkConfig` for TTS, ASR, LLM, Vision models. Pre-built templates for ray0rf1re/nano-nano collection and 30+ architectures (LiquidAI LFM2.5, MiniCPM5, Gemma 4, Qwen3.5, Phi-4, DeepSeek-V2.5, GLM-Edge/MoE, GPT-OSS, Nemotron, Llama-3.2, Mistral-Nemo, Mixtral-8x22B). Includes `TTSEngine`, `ASREngine`, `ASRToTTS` (speech-to-speech), `ASRToLLMToTTS` (conversational pipeline). |
-| `hypernix.tvtop` | Backwards-compatibility shim — all functionality moved to `hypernix.tv`. Re-exports everything so `import hypernix.tvtop` continues to work. Console script `tvtop` still registered and points at `hypernix.tv.cli_main`. |
+| `hypernix.tvtop` | Backwards-compatibility shim — all functionality moved to `hypernix.tv`. Re-exports everything so `import hypernix.tvtop` continues to work. Console script `tvtop` now launches the premium `tvtop_plus_plus` dashboard; use `tvtop-old` for the classic view. |
 | `hypernix.lunchbox` | Consistent-schema dataset packager. `Lunchbox.for_eval()` pre-loads the recommended eval-results columns; `pack(path)` / `push_to_hub(repo_id)` routes through `datasets.Dataset.from_list` so the Parquet `huggingface` metadata stays coherent with the column set (fixes the `CastError: column names don't match` path in the Hub viewer). |
 | `hypernix.whisk` | Checkpoint averaging — `swa_average` (uniform mean), `ema` (exponential), `geometric_mean`. Accepts state dicts or paths to `.pt` / `.safetensors`. `whisk_to_snapshot` writes a full HF-style snapshot in one call. |
 | `hypernix.cutting_board` | Train / val / test splitting. `CuttingBoard` (deterministic random) + `StratifiedBoard` (preserves class distribution on labelled records). Renormalises ratios; writes per-split files with `.slice_to_files()`. |
@@ -120,7 +122,19 @@ Cross-platform: Linux, macOS, Windows. Python 3.10 – 3.14.
 
 ---
 
-## What's new in v0.70.0
+## What's new in v0.70.4
+
+Seven additions in the 0.70.4 series:
+
+- **`qa`** — `QAProcessor` formats Q&A datasets into causal LM training strings with optional salt/pepper seasoning
+- **`stml`** — Short Term Memory Loss: `STML` context manager (segment folding, untrained hard cap) + `calculate_vram_context` VRAM calculator with CLI
+- **`TurboAbbicus`** — exponential curriculum regulator with configurable hard cap, sine-wave oscillation (CPU-adjusted, never GPU), and VRAM safeguard
+- **`tvtop++` fixes** — layout tree bug (border shifting on refresh), colors matching original tvtop (CPU=green, RAM=magenta, GPU=red), dynamic console resizing, dynamic graph/log widths
+- **`hypernix stml`** CLI subcommand — VRAM context calculator from the shell
+- **`hypernix train run`** new flags — `--use-abbicus`, `--use-turbo-abbicus`, `--use-stml`, `--untrained-max-context`, `--segment-length`
+- **`CodeOven.train()`** new kwargs — `use_turbo_abbicus`, `use_stml`, `untrained_max_context`, `segment_length`
+
+### Earlier: v0.70.0
 
 Five new modules + major optimizer rewrites:
 
@@ -129,7 +143,7 @@ Five new modules + major optimizer rewrites:
 - **`pressure_cooker` V2** — Quantization-aware training with fp16/bf16/fp64 mixed-precision, QAT hooks for Q8/Q6/Q5.5/Q4M, plus 10 upgrades (gradient checkpointing, adaptive clipping, EMA shadowing, distributed awareness, dynamic loss scaling, parameter freezing callbacks, LR finder, tvtop metrics streaming)
 - **`pressure_cooker_v3`** — ZeRO-1/2 optimizations, FP8 support, `QuantDtype` enum + `QuantConfig` dataclass
 - **`workshop`** — Model frameworks for TTS/ASR/LLM/Vision with pre-built templates, nano-nano collection support, 30+ architectures (LiquidAI LFM2.5, MiniCPM5, Gemma 4, Qwen3.5, Phi-4, DeepSeek-V2.5, GLM-Edge/MoE, GPT-OSS, Nemotron, Llama-3.2, Mistral-Nemo, Mixtral-8x22B)
-- **`tvtop`** — Now a backwards-compatibility shim re-exporting from `hypernix.tv`
+- **`tvtop`** — Now launches the premium `tvtop_plus_plus` dashboard by default; use `tvtop-old` for the classic view
 
 ## Install
 
@@ -276,6 +290,17 @@ hypernix <subcommand> [options]
   generate              sample text from a local snapshot
   oven                  code-generation wrapper (preheat + complete / fill)
   chat                  interactive chat REPL against any supported model
+  stml                  VRAM trained context length calculator
+```
+
+`train run` accepts curriculum / context management flags:
+
+```bash
+hypernix train run --model-dir ./snap --dataset data.txt --out-dir ./out \
+    --use-turbo-abbicus \        # exponential curriculum (--use-abbicus for linear)
+    --use-stml \                 # fold long sequences into batch segments
+    --untrained-max-context 16384 \
+    --segment-length 512
 ```
 
 Quant aliases accepted by `--quants` and `hypernix quantize` (v0.51.3
@@ -356,7 +381,9 @@ Topic-focused reference guides live in the `wiki/` directory:
 - [`wiki/Ranges.md`](wiki/Ranges.md) — `new_range` / `old_range` / `industrial_range` (labeling rubrics)
 - [`wiki/Freezer.md`](wiki/Freezer.md) — VRAM manager (OldFreezer / NewFreezer / FlashFreezer)
 - [`wiki/Alarms.md`](wiki/Alarms.md) — smoke alarms (Rads / Gas / Modern / Auto) + CPU / GPU preset tables
-- [`wiki/Kitchen.md`](wiki/Kitchen.md) — pans / microwave / table / sink / instant pot / coffee maker / pressure cooker
+- [`wiki/Kitchen.md`](wiki/Kitchen.md) — pans / microwave / table / sink / instant pot / coffee maker / pressure cooker / qa
+- [`wiki/Abbicus.md`](wiki/Abbicus.md) — Abbicus (linear) and TurboAbbicus (exponential + sine oscillation)
+- [`wiki/STML.md`](wiki/STML.md) — Short Term Memory Loss context manager and VRAM calculator
 - [`wiki/Pascal.md`](wiki/Pascal.md) — CUDA 6.1 / GTX 1080 playbook
 - [`wiki/Architectures.md`](wiki/Architectures.md) — ARCH_PRESETS and KNOWN_MODELS
 - [`wiki/Training.md`](wiki/Training.md) — scratch training, expansion, and fine-tuning flows

{hypernix-0.70.2 → hypernix-0.70.4}/README.md

@@ -43,10 +43,12 @@ quantize, and ship.
 | `hypernix.pepper_shaker` | 3-tier sharp perturbations: `SmallShaker` (MLM-style mask) / `Dish` (typos) / `TallHandmade` (negation). |
 | `hypernix.pressure_cooker` | Custom AdamW optimizer in 5 tiers: base `PressureCooker` + CPU (`StovetopCooker`, `ElectricCooker`) + GPU (`InductionCooker`, `ProCooker`) + `universal_cooker` selector. Grad accumulation, GradScaler integration, fused/foreach AdamW, optional CUDA-graph capture on Pro. v0.70.0 V2 rewrite adds quantization-aware training (fp16/bf16/fp64 mixed-precision, QAT hooks for Q8/Q6/Q5.5/Q4M), gradient checkpointing, adaptive clipping, EMA shadowing, distributed awareness, dynamic loss scaling, parameter freezing callbacks, LR finder, and tvtop metrics streaming. |
 | `hypernix.pressure_cooker_v3` | ZeRO-optimized V3 optimizer with FP8 support. New `QuantDtype` enum (FP8/FP16/FP32/FP64/Q8/Q6/Q5_5/Q4M) and `QuantConfig` dataclass. `PressureCookerV3` class with ZeRO-1/2 support, improved memory efficiency, and heavily tested quantization paths. `PressureCookerV3Plus` adds full QAT with calibration. |
-| `hypernix.abbicus` | Automatic token regulation and curriculum tuning. Dynamically modifies max sequence length and padding/truncation during training based on model size (0.5B–72B), context length, dataset complexity, and global step. Configurable curriculum steps, dynamic padding, and dataset-type awareness (math/code get 8-aligned padding). |
+| `hypernix.abbicus` | Automatic token regulation and curriculum tuning. **`Abbicus`** (linear) dynamically modifies max sequence length based on model size (0.5B–72B), global step, and dataset type. **`TurboAbbicus`** (v0.70.4) grows context exponentially to a configurable `hard_cap`, then oscillates using a sine wave adjusted by CPU load (never GPU). Includes VRAM safeguard that scales back context when memory is tight. |
+| `hypernix.qa` | *(v0.70.4)* **`QAProcessor`** — turns structured datasets (JSONL, `list[dict]`, plain text) into causal LM training strings. Two modes: `question_answer` (`Question: {q}\nAnswer: {a}`) and `predict_next` (concatenation). Optional `salt_shaker` / `pepper_shaker` seasoning applied *before* templating so template keywords are never corrupted. |
+| `hypernix.stml` | *(v0.70.4)* **Short Term Memory Loss** — two tools. `calculate_vram_context(vram_gb, params, batch_size, precision)` estimates the max safe trained context given your hardware. `STML` context manager enforces an `untrained_max_context` hard cap and folds long sequences into `(batch × segments, segment_length)` chunks so the model trains on all the data. Integrates with Abbicus / TurboAbbicus. CLI: `hypernix stml --vram 24 --params 7`. |
 | `hypernix.compute_framework` | Hardware-agnostic multi-device training. Abstracts CUDA, MPS, CPU, TPU backends with automatic DDP/ZeRO wrapping. `ComputeFramework` handles PyTorch DDP initialization, device placement, fallback logic. Supports `local_rank`, `world_size`, `use_ddp`, `use_fsdp`, `zero_stage`. Auto-detects backend and sets up device. |
 | `hypernix.workshop` | Model frameworks and TTS/ASR pipelines. `WorkshopFramework` base class with `FrameworkConfig` for TTS, ASR, LLM, Vision models. Pre-built templates for ray0rf1re/nano-nano collection and 30+ architectures (LiquidAI LFM2.5, MiniCPM5, Gemma 4, Qwen3.5, Phi-4, DeepSeek-V2.5, GLM-Edge/MoE, GPT-OSS, Nemotron, Llama-3.2, Mistral-Nemo, Mixtral-8x22B). Includes `TTSEngine`, `ASREngine`, `ASRToTTS` (speech-to-speech), `ASRToLLMToTTS` (conversational pipeline). |
-| `hypernix.tvtop` | Backwards-compatibility shim — all functionality moved to `hypernix.tv`. Re-exports everything so `import hypernix.tvtop` continues to work. Console script `tvtop` still registered and points at `hypernix.tv.cli_main`. |
+| `hypernix.tvtop` | Backwards-compatibility shim — all functionality moved to `hypernix.tv`. Re-exports everything so `import hypernix.tvtop` continues to work. Console script `tvtop` now launches the premium `tvtop_plus_plus` dashboard; use `tvtop-old` for the classic view. |
 | `hypernix.lunchbox` | Consistent-schema dataset packager. `Lunchbox.for_eval()` pre-loads the recommended eval-results columns; `pack(path)` / `push_to_hub(repo_id)` routes through `datasets.Dataset.from_list` so the Parquet `huggingface` metadata stays coherent with the column set (fixes the `CastError: column names don't match` path in the Hub viewer). |
 | `hypernix.whisk` | Checkpoint averaging — `swa_average` (uniform mean), `ema` (exponential), `geometric_mean`. Accepts state dicts or paths to `.pt` / `.safetensors`. `whisk_to_snapshot` writes a full HF-style snapshot in one call. |
 | `hypernix.cutting_board` | Train / val / test splitting. `CuttingBoard` (deterministic random) + `StratifiedBoard` (preserves class distribution on labelled records). Renormalises ratios; writes per-split files with `.slice_to_files()`. |
@@ -66,7 +68,19 @@ Cross-platform: Linux, macOS, Windows. Python 3.10 – 3.14.
 
 ---
 
-## What's new in v0.70.0
+## What's new in v0.70.4
+
+Seven additions in the 0.70.4 series:
+
+- **`qa`** — `QAProcessor` formats Q&A datasets into causal LM training strings with optional salt/pepper seasoning
+- **`stml`** — Short Term Memory Loss: `STML` context manager (segment folding, untrained hard cap) + `calculate_vram_context` VRAM calculator with CLI
+- **`TurboAbbicus`** — exponential curriculum regulator with configurable hard cap, sine-wave oscillation (CPU-adjusted, never GPU), and VRAM safeguard
+- **`tvtop++` fixes** — layout tree bug (border shifting on refresh), colors matching original tvtop (CPU=green, RAM=magenta, GPU=red), dynamic console resizing, dynamic graph/log widths
+- **`hypernix stml`** CLI subcommand — VRAM context calculator from the shell
+- **`hypernix train run`** new flags — `--use-abbicus`, `--use-turbo-abbicus`, `--use-stml`, `--untrained-max-context`, `--segment-length`
+- **`CodeOven.train()`** new kwargs — `use_turbo_abbicus`, `use_stml`, `untrained_max_context`, `segment_length`
+
+### Earlier: v0.70.0
 
 Five new modules + major optimizer rewrites:
 
@@ -75,7 +89,7 @@ Five new modules + major optimizer rewrites:
 - **`pressure_cooker` V2** — Quantization-aware training with fp16/bf16/fp64 mixed-precision, QAT hooks for Q8/Q6/Q5.5/Q4M, plus 10 upgrades (gradient checkpointing, adaptive clipping, EMA shadowing, distributed awareness, dynamic loss scaling, parameter freezing callbacks, LR finder, tvtop metrics streaming)
 - **`pressure_cooker_v3`** — ZeRO-1/2 optimizations, FP8 support, `QuantDtype` enum + `QuantConfig` dataclass
 - **`workshop`** — Model frameworks for TTS/ASR/LLM/Vision with pre-built templates, nano-nano collection support, 30+ architectures (LiquidAI LFM2.5, MiniCPM5, Gemma 4, Qwen3.5, Phi-4, DeepSeek-V2.5, GLM-Edge/MoE, GPT-OSS, Nemotron, Llama-3.2, Mistral-Nemo, Mixtral-8x22B)
-- **`tvtop`** — Now a backwards-compatibility shim re-exporting from `hypernix.tv`
+- **`tvtop`** — Now launches the premium `tvtop_plus_plus` dashboard by default; use `tvtop-old` for the classic view
 
 ## Install
 
@@ -222,6 +236,17 @@ hypernix <subcommand> [options]
   generate              sample text from a local snapshot
   oven                  code-generation wrapper (preheat + complete / fill)
   chat                  interactive chat REPL against any supported model
+  stml                  VRAM trained context length calculator
+```
+
+`train run` accepts curriculum / context management flags:
+
+```bash
+hypernix train run --model-dir ./snap --dataset data.txt --out-dir ./out \
+    --use-turbo-abbicus \        # exponential curriculum (--use-abbicus for linear)
+    --use-stml \                 # fold long sequences into batch segments
+    --untrained-max-context 16384 \
+    --segment-length 512
 ```
 
 Quant aliases accepted by `--quants` and `hypernix quantize` (v0.51.3
@@ -302,7 +327,9 @@ Topic-focused reference guides live in the `wiki/` directory:
 - [`wiki/Ranges.md`](wiki/Ranges.md) — `new_range` / `old_range` / `industrial_range` (labeling rubrics)
 - [`wiki/Freezer.md`](wiki/Freezer.md) — VRAM manager (OldFreezer / NewFreezer / FlashFreezer)
 - [`wiki/Alarms.md`](wiki/Alarms.md) — smoke alarms (Rads / Gas / Modern / Auto) + CPU / GPU preset tables
-- [`wiki/Kitchen.md`](wiki/Kitchen.md) — pans / microwave / table / sink / instant pot / coffee maker / pressure cooker
+- [`wiki/Kitchen.md`](wiki/Kitchen.md) — pans / microwave / table / sink / instant pot / coffee maker / pressure cooker / qa
+- [`wiki/Abbicus.md`](wiki/Abbicus.md) — Abbicus (linear) and TurboAbbicus (exponential + sine oscillation)
+- [`wiki/STML.md`](wiki/STML.md) — Short Term Memory Loss context manager and VRAM calculator
 - [`wiki/Pascal.md`](wiki/Pascal.md) — CUDA 6.1 / GTX 1080 playbook
 - [`wiki/Architectures.md`](wiki/Architectures.md) — ARCH_PRESETS and KNOWN_MODELS
 - [`wiki/Training.md`](wiki/Training.md) — scratch training, expansion, and fine-tuning flows

{hypernix-0.70.2 → hypernix-0.70.4}/pyproject.toml

@@ -4,13 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hypernix"
-version = "0.70.2"
+version = "0.70.4"
 description = "Download and quantize the HyperNix PyTorch model to GGUF (fp32/fp16/Q8_0/Q6_K/Q4_K_M)."
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { text = "Apache-2.0" }
-# 3.12 is the recommended interpreter, but the code is pure-Python and runs on
-# any CPython that has a torch 2.7.1 wheel. Keep the floor at 3.10 so modern
-# syntax compiles (structural pattern matching, PEP 604 unions).
+# Python 3.12 is preferred and will auto-run if installed.
+# If 3.12 is not found, the package supports running on 3.13 or 3.14.
+# The code is pure-Python and runs on any CPython that has a compatible torch wheel.
+# Keep the floor at 3.10 so modern syntax compiles (structural pattern matching, PEP 604 unions).
 requires-python = ">=3.10,<3.15"
 authors = [{ name = "HyperNix contributors" }]
 keywords = ["hypernix", "gguf", "quantization", "llama.cpp", "pytorch"]
@@ -71,16 +72,22 @@ legacy-torch = [
 ]
 
 [project.scripts]
-hypernix = "hypernix.cli:main"
-hypernix-quantize = "hypernix.cli:main"
-# v0.60.0: tvtop dashboard + ethanol overclock helper.
-tvtop = "hypernix.tv:cli_main"
+hypernix = "hypernix.version_launcher:main"
+hypernix-quantize = "hypernix.version_launcher:main"
+hnx = "hypernix.version_launcher:main"
+# v0.70.4b12: cctvtop C++ dashboard replaces tvtop++.
+tvtop = "hypernix.cctvtop:cli_main"
+cctvtop = "hypernix.cctvtop:cli_main"
+tvtop-old = "hypernix.tvtop_plus_plus:cli_main"
+tvtop-older = "hypernix.tv:cli_main"
+tvtop-plus-plus = "hypernix.tvtop_plus_plus:cli_main"
+tvtoppp = "hypernix.tvtop_plus_plus:cli_main"
 eth = "hypernix.ethanol:cli_main"
 # v0.61.1: high-quality TUI chat CLI with a configurator.
 hyped = "hypernix.hyped:cli_main"
 
 [project.urls]
-Homepage = "https://huggingface.co/ray0rf1re/hyper-Nix.2"
+Homepage = "https://minerofthesoal.github.io/HyperNix-pip/"
 Source = "https://github.com/minerofthesoal/hypernix-pip"
 Issues = "https://github.com/minerofthesoal/hypernix-pip/issues"
 Logo = "https://raw.githubusercontent.com/minerofthesoal/hypernix-pip/main/assets/logo.png"
@@ -96,7 +103,7 @@ where = ["src"]
 include = ["hypernix*"]
 
 [tool.setuptools.package-data]
-hypernix = ["py.typed"]
+hypernix = ["py.typed", "webui_static/*"]
 
 # ---------------------------------------------------------------------------
 # Ruff / pytest defaults (also duplicated in ruff.toml / pytest.ini so

{hypernix-0.70.2 → hypernix-0.70.4}/scripts/install_deps.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Cross-distro bootstrap for `hypernix`. Installs Python 3.12 + pip and then
+# Cross-distro bootstrap for `hypernix`. Prefers Python 3.12 if installed with hypernix,
+# otherwise falls back to 3.13 or 3.14 (checking each for hypernix). Installs pip and then
 # `pip install "hypernix[llama-cpp]"` into a local virtualenv at ./.venv.
 #
 # Supported: Ubuntu/Debian/Mint/Pop!_OS, Arch/Manjaro/EndeavourOS, Fedora/RHEL,
@@ -12,7 +13,33 @@
 set -euo pipefail
 
 VENV="${VENV:-./.venv}"
-PY=python3.12
+
+# Function to check if hypernix is installed for a given python version
+check_hypernix_installed() {
+  local py_cmd="$1"
+  "$py_cmd" -c "import hypernix" >/dev/null 2>&1
+}
+
+# Prefer Python 3.12 if available with hypernix; otherwise try 3.13, then 3.14, then generic python3
+PY=""
+for version in python3.12 python3.13 python3.14 python3; do
+  if command -v "$version" >/dev/null 2>&1; then
+    if check_hypernix_installed "$version"; then
+      PY="$version"
+      break
+    fi
+  fi
+done
+
+# If no version with hypernix found, just pick the first available python
+if [[ -z "$PY" ]]; then
+  for version in python3.12 python3.13 python3.14 python3; do
+    if command -v "$version" >/dev/null 2>&1; then
+      PY="$version"
+      break
+    fi
+  done
+fi
 
 . /etc/os-release 2>/dev/null || true
 ID="${ID:-unknown}"
@@ -40,19 +67,27 @@ install_system_packages() {
     *ubuntu*|*debian*|*mint*|*pop*|*elementary*)
       require_sudo
       $SUDO apt-get update
+      # Try to install Python 3.12 first (preferred), but allow fallback to system default
       if ! apt-cache show python3.12 >/dev/null 2>&1; then
         $SUDO apt-get install -y software-properties-common
         $SUDO add-apt-repository -y ppa:deadsnakes/ppa || true
         $SUDO apt-get update
       fi
-      $SUDO apt-get install -y python3.12 python3.12-venv python3-pip
+      # Install 3.12 if available, otherwise use system python3
+      if apt-cache show python3.12 >/dev/null 2>&1; then
+        $SUDO apt-get install -y python3.12 python3.12-venv python3-pip
+      else
+        $SUDO apt-get install -y python3 python3-venv python3-pip
+      fi
       ;;
     *fedora*|*rhel*|*almalinux*|*rocky*|*centos*)
       require_sudo
+      # Try 3.12 first, fall back to system python3
       $SUDO dnf install -y python3.12 python3.12-pip || $SUDO dnf install -y python3 python3-pip
       ;;
     *opensuse*|*suse*|*sles*)
       require_sudo
+      # Try 3.12 first, fall back to system python3
       $SUDO zypper install -y python312 python312-pip || $SUDO zypper install -y python3 python3-pip
       ;;
     *alpine*)
@@ -65,7 +100,7 @@ install_system_packages() {
       echo "  nix-shell -p python312 gcc -- --run 'bash scripts/install_deps.sh'" >&2
       ;;
     *)
-      echo "Unrecognized distro ($ID). Ensure 'python3.12' + 'pip' are on PATH, then rerun." >&2
+      echo "Unrecognized distro ($ID). Ensure 'python3.12', 'python3.13', 'python3.14', or 'python3' is on PATH, then rerun." >&2
       ;;
   esac
 }
@@ -73,9 +108,28 @@ install_system_packages() {
 main() {
   install_system_packages
 
-  if ! command -v "$PY" >/dev/null 2>&1; then
-    # Fall back to a generic python3 binary if 3.12 isn't available.
-    PY=$(command -v python3 || true)
+  # Re-detect Python after system package installation
+  if [[ -z "$PY" ]] || ! command -v "$PY" >/dev/null 2>&1; then
+    # Fall back to a generic python3 binary if preferred version isn't available.
+    PY=""
+    # First try to find a version with hypernix already installed
+    for version in python3.12 python3.13 python3.14 python3; do
+      if command -v "$version" >/dev/null 2>&1; then
+        if check_hypernix_installed "$version"; then
+          PY="$version"
+          break
+        fi
+      fi
+    done
+    # If no version with hypernix found, just pick the first available python
+    if [[ -z "$PY" ]]; then
+      for version in python3.12 python3.13 python3.14 python3; do
+        if command -v "$version" >/dev/null 2>&1; then
+          PY="$version"
+          break
+        fi
+      done
+    fi
     [[ -n "$PY" ]] || { echo "no python3 on PATH" >&2; exit 1; }
   fi
 

{hypernix-0.70.2 → hypernix-0.70.4}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = hypernix
-version = 0.70.2
+version = 0.70.4
 description = Download and quantize the HyperNix PyTorch model to GGUF (fp32/fp16/Q8_0/Q6_K/Q4_K_M).
 long_description = file: README.md
 long_description_content_type = text/markdown
@@ -65,6 +65,9 @@ legacy-torch =
 console_scripts = 
 	hypernix = hypernix.cli:main
 	hypernix-quantize = hypernix.cli:main
+	hnx = hypernix.cli:main
+	tvtop++ = hypernix.tvtop_plus_plus:cli_main
+	tvtoppp = hypernix.tvtop_plus_plus:cli_main
 
 [egg_info]
 tag_build = 

hypernix-0.70.4/setup.py

@@ -0,0 +1,30 @@
+"""Legacy setup.py shim.
+
+All real configuration lives in ``pyproject.toml`` (PEP 621). This file
+exists so ``python setup.py <cmd>`` and ``pip install .`` work with
+older tooling and with integrators that still look for ``setup.py``
+in the project root.
+"""
+import os
+from setuptools import setup, Extension
+
+# By default, do not build the C++ extension during standard wheel builds
+# to ensure we produce a universal py3-none-any.whl for PyPI.
+# Users installing from source or those who explicitly set BUILD_CCTVTOP=1
+# will get the compiled C++ cctvtop dashboard.
+build_cctvtop = os.environ.get("BUILD_CCTVTOP", "0") == "1"
+
+ext_modules = []
+if build_cctvtop:
+    cctvtop_ext = Extension(
+        "hypernix.cctvtop_ext",
+        sources=["src/hypernix/cctvtop.cpp"],
+        language="c++",
+        extra_compile_args=["-std=c++17", "-O3"],
+    )
+    ext_modules.append(cctvtop_ext)
+
+if __name__ == "__main__":
+    setup(
+        ext_modules=ext_modules,
+    )