Loomy (luminamoon) Documentation Portal¶
Loomy(luminamoon) is the official reference implementation and central monorepo of PROJECT LOOMY, providing low-precision numerical optimization, multimodal dataset streaming, and formal verification suites developed by Silver Moon (@cloverxion) and Lumina Moon (@cloverx-id) contributors.
Getting Started
System requirements, pip install, Rust compilation, and quickstart examples for NumPy, PyTorch, and Data Engine.
LuminaV Optimizer
Dual-Buffer CLM vs Single-Buffer TD-CLM, mixed-precision, stochastic rounding, and FSDP distributed training.
Data Engine
Fused SIMD preprocessing, StringTensor zero-copy buffers, streaming datasets, and 128B Ping-Pong crash recovery.
API Reference
Complete signatures, parameter reference tables, validation constraints, and return types for all modules.
Security & Audits
Direct vulnerability disclosure policy to Silver Moon, CodeQL scanning, and third-party library safety audits.
Changelogs
Version-by-version release history for Software package distributions and LuminaV algorithm specifications.
1. User Documentation¶
Source directory: docs/en/
- 01. Getting Started: System requirements, installation, source compilation via Maturin/Rust, hardware & SIMD ISA auditing (
LuminaV.detect_hardware(),lm.data_cpu_isa()), and quickstarts for NumPy, PyTorch, and DataLoader (FusedPipeline,StringTensor,StateTracker,ResumablePipeline). - 02. User Guide: Optimizer buffer modes (Dual-Buffer CLM vs Single-Buffer TD-CLM), mixed-precision & stochastic rounding, boundary dynamics, FSDP distributed training, plus DataLoader \(O(1)\) local/HTTP-206 streaming, 100-batch Pre-RAM watermark ring buffer, Ping-Pong crash recovery, two-stage XXH3-64 deduplication, and multimodal HuggingFace Hub pipelines.
- 03. Configuration & API Reference: Complete parameter reference tables, public methods, and validation rules for
LuminaV,TextCleaner,QualityFilter,StreamDeduplicator,MinHashDeduplicator,PIIMasker,StateTracker,StreamCoordinate,StringTensor,FusedPipeline, andResumablePipeline. - 04. Architecture & Hardware Acceleration: C4 dispatch hierarchy, Optimizer Rust crates (
core,simd,vulkan,dispatch,triton-aot), Data Engine Rust modules (constants,coord,dedup,error,metadata,minhash,postprocess,py_bridge,quality,serialize,simd_cpu,string_tensor), zero-copy memory protocols, and free-threaded Python (abi3t/ PEP 703).
2. Developer Modular Documentation¶
Deep technical documentation for systems engineers, kernel writers, and library developers (docs/optimize/ & data/docs/):
A. LuminaV Optimizer¶
Source directories: docs/optimize/ & optimizer/
- LuminaV Optimizer Overview & User Guide (
optimizer/README.md) - Developer Optimizer Index (
docs/optimize/README.md) - 01. Core & Math: CLM, TD-CLM temporal difference, PRNG stochastic rounding, and bias correction.
- 02. SIMD Vectorization: AVX-512 and AVX2/FMA x86_64 intrinsics and Rayon parallel threadpool.
- 03. Vulkan Compute: Ash Vulkan 1.3/1.4 SPIR-V compute shaders and UMA zero-copy host buffers.
- 04. Triton AOT & GPU Drivers: AOT compilation, CUDA/HIP driver dynamic loading, and standalone C-API.
- 05. Dispatch & Routing: Hardware capability detector and 16,384-element dispatch threshold heuristic.
- 06. Python FFI & PyO3 Bridge: PyO3 GIL release (
py.detach()), anti-aliasing safety, and NumPy buffer protocols. - 07. Python Runtime & GPU Mixin:
LuminaVclass,constants.py, Triton JIT kernels, FSDP synchronization, and state checkpointing.
B. LuminaMoon Data Engine¶
Source directories: data/ & data/docs/
- LuminaMoon Data Engine Overview & User Guide (
data/README.md) - Data Engine Standalone Portal (
data/docs/README.md) - Developer Data Engine Index (
data/docs/README.md) - 01. TextCleaner & QualityFilter: AVX-512/AVX2/NEON SIMD carriage-return stripping, JSON extraction, Shannon entropy, repetition loop, and symbol ratio heuristics.
- 02. StreamDeduplicator & MinHashDeduplicator: High-throughput exact streaming deduplication with
xxh3_64(IdentityBuildHasherSwissTable), WAL persistence, and 64-permutation MinHash LSH fuzzy deduplication. - 03. PIIMasker & Data Sanitization: Pattern-based and regex sanitizer for emails, IPv4 addresses, phone numbers, and custom secret tokens.
- 04. StateTracker & StreamCoordinate: 32-byte
StreamCoordinatenavigation, dual-slot 128-byte crash-proof Ping-Pong persistence, and multi-epoch state tracking. - 05. StringTensor & Memory Layouts: CPU StringView (inlined <= 12 bytes) and GPU contiguous offset/payload buffers compatible with PyTorch, NumPy, Arrow, and Polars.
- 06. FusedPipeline & ResumablePipeline: Multi-threaded Rayon single-pass pipeline (>400k records/s) and resumable streaming pipeline with async background prefetcher.
- 07. Multimodal Serialization: Zero-copy serialization to JSONL, Parquet with Zstd compression and embedded image payloads, Arrow IPC, and CSV.
3. Engineering & External Library Audits¶
Source directories: docs/library_audit/ & data/docs/library_audit/
- Optimizer Library Audit Suite (
docs/library_audit/): Technical verification and ABI compliance audits for Rust 1.99.1 toolchain, PyO3/Maturin, PyTorch 2.14.1, Triton JIT 3.8.0, CUDA/ROCm, and Vulkan Ash compute pipeline. - Data Engine Standalone Library Audit Suite (
data/docs/library_audit/): Technical verification and codebase adaptations for Rust 1.99.1 / Edition 2024,pyo3 0.30.1(abi3t), Apache Arrow/Parquet/IPC60.0.0,rayon 1.12.0,xxhash-rust 0.8.19(xxh3),crc32fast 1.5.2,hashbrown 0.17.1,parking_lot 0.12.5,serde 1.0.229, and HuggingFace Hub API protocols.