Skip to content

Helron1977/Hypercube-Compute

Repository files navigation

Hypercube Neo: Cognitive Simulation Core ๐ŸŒŠ๐Ÿš€

Hypercube Neo is a state-of-the-art Spatial Computing & Physical Simulation Engine. Built specifically for high-performance fluid dynamics, cellular automata, and volumetric computing, it bridges the gap between hardware-agnostic declarative manifests and high-fidelity real-time execution.

Hypercube Neo Logo

Pure O(1) Cognitive Engine โ€ข Zero-Allocation Tensors โ€ข WebGPU & Multithreaded CPU

Version License: MIT Build: Passing


๐ŸŽฅ Visual Performance (60 FPS)

Hypercube Neo achieves consistent 60 FPS performance by leveraging a Zero-Stall Pipeline and Contiguous Memory Tensors.

Ocean GPU Demo Real-time fluid vorticity and bio-advection calculated via WebGPU (Hypercube Neo).


๐Ÿ”ฅ Core Philosophy

Traditional engines struggle with object-oriented bottlenecks. Hypercube Neo treats the world as a Hypercube of data tensors:

  • O(1) Complexity: Execution time is determined by grid resolution, not the number of interacting objects.
  • Zero-Copy Architecture: SharedArrayBuffer (CPU) and VRAM-to-VRAM (GPU) orchestration eliminates costly memory transfers.
  • Manifest-Driven: Define physics, topology, and visuals in a single JSON schema. High-level architecture is entirely decoupled from numerical kernels.

๐Ÿ—๏ธ Repository Architecture

The project is structured following industrial standards for high-performance compute libraries:

  • /core: The heart of the engine (Physical mapping, Dispatchers, Orchestration).
    • /memory: MasterBuffer (VRAM/RAM anchor) and IBufferBridge.
    • /topology: VirtualGrid and ParityManager.
  • /io: Input/Output adapters (Canvas Rendering, WebHooks).
  • /showcase: Interactive demo hub for Neo simulations.
  • /kernels: Pure numerical algorithms (LBM, Advection, Diffusion).
  • /docs: Comprehensive technical guides and architectural concepts.

๐Ÿš€ Quick Start

Launch a multi-threaded fluid simulation in seconds:

import { HypercubeNeoFactory } from './core/HypercubeNeoFactory';

const factory = new HypercubeNeoFactory();
const manifest = await factory.fromManifest('./showcase/cpu/aero-cpu.json');
const engine = await factory.build(manifest.config, manifest.engine);

async function loop() {
    await engine.step(); // O(1) Compute step
    requestAnimationFrame(loop);
}
loop();

๐Ÿš€ Showcases & Use Cases

Hypercube Neo features several high-performance simulations accessible via the Showcase Hub.

๐ŸŒฌ๏ธ Aerodynamics (LBM)

Simulate high-fidelity airflows over complex geometries using the Lattice Boltzmann Method.

๐ŸŒก๏ธ Thermal Diffusion

Compute multi-dimensional heat transport with interactive obstacle handling.

๐Ÿงฎ Tensor-CP Decomposition (NEW)

Decompose 3D data tensors using the Alternating Least Squares (ALS) algorithm.

๐Ÿ“ Spatial SDF (Jump Flooding)

Generate Signed Distance Fields in $O(\log N)$ time for complex environments.

๐Ÿงฌ Cellular Automata

Massively parallel implementation of Conway's Game of Life.


Part of the MonOs Cognitive Copilot ecosystem. Built for the era of agentic computing.

About

O(1) Tensor-based Compute Engine for Web & Node.js

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors