ARBS / docs /ARB-RENAME-NOTE.md
CLIWorks's picture
Upload folder using huggingface_hub
d8bc908 verified
metadata
title: ARB System Rename
date: 2026-05-18T00:00:00.000Z
context: System renamed from MORPH to ARB (Any Relational Bit)

ARB System β€” Rename Note

New Name

The system has been renamed from MORPH to ARB (Any Relational Bit).

  • ARB = Any Relational Bit β€” the core ternary architecture
  • ARBS = ARB System β€” the full software system
  • ARBitor = The Python package name (arbitor/)

Package Structure

All core system files now live under arbitor/:

models/Trigram/
β”œβ”€β”€ arbitor/                    # Core ARB system package
β”‚   β”œβ”€β”€ __init__.py            # Public API exports
β”‚   β”œβ”€β”€ trigram.py             # Core model (ARBModel replaces MORPHTernaryModel)
β”‚   β”œβ”€β”€ tscale.py              # Ternary scale tensors
β”‚   β”œβ”€β”€ convert_to_ternary.py  # 5-trit packing
β”‚   β”œβ”€β”€ convert_to_ternary*.py # Legacy converters
β”‚   β”œβ”€β”€ flash_vq.py            # FlashVQ codebook
β”‚   β”œβ”€β”€ ternary_audit.py       # Model state auditor
β”‚   β”œβ”€β”€ profiling.py            # Profiling utilities
β”‚   β”œβ”€β”€ train.py               # Training pipeline
β”‚   β”œβ”€β”€ optim/
β”‚   β”‚   └── sign_sgd.py        # SignSGD optimizer
β”‚   └── encoders/              # Float sidecar encoders
β”‚       β”œβ”€β”€ __init__.py
β”‚       β”œβ”€β”€ audio_codec.py
β”‚       β”œβ”€β”€ audio_vq_encoder.py
β”‚       └── video_vae.py
β”œβ”€β”€ testing/                   # Tests (import from arbitor)
β”œβ”€β”€ .planning/                 # Planning docs (P0-P10 complete)
β”œβ”€β”€ TRUE-TERNARY-REFACTOR*.md  # Architecture refactor notes
β”œβ”€β”€ BENCHMARK.md               # Benchmark docs
└── benchmark_true_ternary.py  # Benchmark scripts

Import Changes

Before After
from trigram import ARBModel from arbitor.trigram import ARBModel
from tscale import TernaryScaleTensor from arbitor.tscale import TernaryScaleTensor
from optim.sign_sgd import SignSGD from arbitor.optim.sign_sgd import SignSGD
from encoders.video_vae import load_vae from arbitor.encoders.video_vae import load_vae
from arbitor import ARBModel Shorthand via arbitor/__init__.py
import trigram from arbitor import trigram

Class Rename

Before After
MORPHTernaryModel ARBModel