Documentation

Quickstart

  1. Install the Extension: Install from the Open VSX Registry.
  2. Scan Hardware: Open the R1 Hardware Dashboard to analyze your VRAM and system memory.
  3. Validate & Run: Select a local model configuration. The engine will pre-calculate stability.
  4. Review Authority Decision:
    • ALLOW: Safe to run.
    • DOWNGRADED: Modified parameters to prevent crash.
    • DENY: Predicted crash. Execution blocked.

Authority Modes

Advisory Mode: Allows most requests to proceed with warnings and recommended downgrades. However, configurations predicted to freeze or crash the system are blocked to prevent instability or forced reboots.

Enforced Mode (Default): The engine strictly blocks any execution predicted to destabilize the OS or GPU driver.

The Hard Wall

The Hard Wall is a safety boundary enforced when a requested configuration is predicted to destabilize the system.

This includes conditions such as:

  • VRAM pressure exceeding safe thresholds
  • High likelihood of GPU out-of-memory errors
  • OS-level swapping that would freeze or hang the system

Some DENY outcomes represent crash-risk conditions, not absolute physical impossibility. In these cases, Premium stabilization strategies may safely convert the request into a DOWNGRADED configuration.

True physical limits — where a model cannot fit even under maximum compression and reduction — remain non-negotiable and are always denied.

Detailed architecture, formulas, and advanced configuration are available in the repository.

View Full Documentation on GitHub