Skip to main content

Introduction

Welcome to the Bluefin Framework wtgOS documentation.

This project is a highly specialized "spin" of Bluefin-DX, custom-built for the Framework Laptop 13 and advanced Agentic AI workflows.

What is wtgOS?​

wtgOS is designed for developers who want the stability and security of an immutable OS, paired with a high-performance, isolated environment for AI development.

The Foundation: Bluefin-DX​

We build upon Bluefin-DX, inheriting:

  • Atomic Updates: Never worry about a broken system update.
  • Cloud-Native Tooling: Docker, Podman, and Kind ready out of the box.
  • Ubuntu Compatibility: Homebrew and Distrobox provide a familiar ecosystem.

The Layer: wtgOS Additions​

On top of the Bluefin base, we add:

  • Framework 13 Optimization: Specific kernel tuning for Ryzen AI 300 series.
  • Quarantined AI: A dedicated, declarative Distrobox for AI agents with ROCm passthrough.
  • TDI Validation: Test-Driven Infrastructure ensures your OS is always verified.

Getting Started​

Ready to dive in? Check out the Installation Guide to get your Framework 13 running wtgOS.

Target Hardware Manifest​

  • System: Framework Laptop 13
  • Processor: AMD Ryzen™ AI 300 Series - Ryzen™ AI 9 HX 370 (Zen 5, RDNA 3.5, XDNA 2 NPU)
  • Memory: 96GB (2 x 48GB) DDR5-5600 (UMA maximized via BIOS for local LLM inference)
  • Storage: 2TB WD_BLACK™ SN850X NVMe™ M.2 2280
  • Display: 2.8K (2880x1920, 3:2 ratio - Wayland 150% fractional scaling defaults)
  • Expansion I/O: USB-C, USB-A, HDMI (3rd Gen), and Ethernet.