Installation & Setup
Bluefin Framework wtgOS is designed to be installed as a rebase from an existing Bluefin or Fedora-based atomic installation, or via a fresh install if you have the OCI image URL.
Rebasing to wtgOS
If you are already running Bluefin-DX or another Fedora Silverblue-based distribution, you can rebase your system to wtgOS with a single command:
rpm-ostree rebase ostree-unverified-registry:ghcr.io/wtg-codes/bluefin-framework-antigravity:latest
After the rebase is complete, reboot your system:
systemctl reboot
Post-Installation Setup
Once you have rebooted into wtgOS, you should initialize the AI quarantine environment:
ujust setup-workspace
This command will:
- Create the workspace directory at
~/.local/share/antigravity-workspace. - Assemble the Distrobox container using the declarative configuration.
- Set up ROCm hardware passthrough for the Ryzen AI 300 GPU/NPU.
Verification
You can verify that your system is correctly configured by running the built-in validation suite:
bats /usr/share/bluefin-framework/tests/os_validation.bats