wtgOS 🐟🚀

Welcome to the future, friends! wtgOS is a custom, opinionated, cloud-native developer appliance based on Project Bluefin-DX + Google dev tools. We treat the desktop like cattle, not pets—featuring a read-only root filesystem, automated updates, and zero host-level pollution.

Tip

View the Live Documentation & Dashboard for build status, latest images, and setup guides.

📥 Installation

Option 1: The "Bluefin Way" (Rebase)

If you are already running a Fedora Atomic / uBlue installation, just open your terminal and run:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/wtg-codes/bluefin-framework-antigravity:latest

Then reboot!

Option 2: Clean Install (Bare Metal)

Head over to the Releases page and download the latest .iso file. Flash it to a USB drive using BalenaEtcher or Fedora Media Writer.

🚀 The Cloud-Native Laboratory

wtgOS is built for Cloud-Native Computing students and Multi-Agent Systems orchestration.

• Immutable Host: The host OS exists only to run containers and hardware drivers. No host-level SDKs!
• Declarative Workspace: All student development happens inside a high-performance Distrobox (wtg-workspace) baked with kubectl, helm, k9s, kind, and Google dev tools.
• AI Quarantine: Isolated AI agent execution with direct hardware passthrough (ROCm) for GPU/NPU workloads.
• Zero-Trust CI/CD: Every image is cryptographically signed and every ISO is verified before publication.

🛠️ Student Quick Start

Once you have booted into wtgOS, bootstrap your workspace:

ujust setup-workspace
ujust start-cluster

📖 Technical Reference

• 🛠️ Architecture (ADRs)
• 🛡️ Security Model
• 📖 Operations Runbook

🤝 Upstream First

This project stands on the shoulders of giants. If you find a bug in the desktop environment, please report it to Fedora or GNOME.

---

Built with ❤️ using BlueBuild.