build

# Build - Unified Build System

## Overview

The `build` command provides a unified interface for all bazzite-ai build operations:

- OS container images
- Pod container variants
- VM images (QCOW2/RAW)
- Live ISO installers
- Push to registry
- Sign with cosign

**Smart Caching:** Automatically detects git branch and uses matching cache tag, ensuring local builds are compatible with GitHub Actions builds.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Build OS | `just build os` | Build OS container image |
| Build pod | `just build pod nvidia` | Build specific pod variant |
| Build all pods | `just build pod all` | Build all pod variants |
| Build ISO | `just build iso` | Build live ISO installer |
| Build QCOW2 | `just build qcow2` | Build QCOW2 VM image |
| Build RAW | `just build raw` | Build RAW VM image |
| Generate lock | `just build pixi python` | Generate pixi.lock |
| Push OS | `just build push os` | Push OS image to registry |
| Push pod | `just build push pod nvidia` | Push pod to registry |
| Sign OS | `just build sign os` | Sign OS image with cosign |
| Sign pod | `just build sign pod nvidia` | Sign pod with cosign |
| Show status | `just build status` | Show cache/build status |

## Pod Variants

| Variant | Image Name | Description |
|---------|------------|-------------|
| `base` | `bazzite-ai-pod` | CPU-only development |
| `nvidia` | `bazzite-ai-pod-nvidia` | GPU compute with CUDA |
| `nvidia-python` | `bazzite-ai-pod-nvidia-python` | NVIDIA + ML packages |
| `jupyter` | `bazzite-ai-pod-jupyter` | JupyterLab + ML stack |
| `ollama` | `bazzite-ai-pod-ollama` | LLM inference |
| `comfyui` | `bazzite-ai-pod-comfyui` | Stable Diffusion UI |
| `devops` | `bazzite-ai-pod-devops` | AWS/kubectl/Helm tools |
| `githubrunner` | `bazzite-ai-pod-githubrunner` | CI/CD pipeline |

## Smart Cache Strategy

The build system automatically detects your git branch and uses the appropriate cache tag to maximize cache reus