Skip to content

Testing

Bazzite AI includes a comprehensive testing framework for validating install commands and other system features.

Overview

The testing framework provides:

  • Automated testing of all ujust install commands
  • JSON results for CI/CD integration
  • Service lifecycle testing with automatic cleanup

Quick Start

# Enable overlay testing (one-time setup)
just test overlay enable

# Run all install tests
just test install all

# Run tests for specific category
just test install dev-tools
just test install flatpaks
just test install services

# View results
just test install status

# Generate documentation from results
just test install generate-docs

Test Categories

Tools for development and AI assistance:

  • claude-code - Claude Code AI assistant CLI
  • pixi - Conda-compatible package manager
  • chunkhound - Semantic code search MCP server
  • devcontainers-cli - Dev Container CLI

Application packages via Flatpak:

  • flatpaks-dev - Development tools
  • flatpaks-media - Media applications
  • flatpaks-gaming - Gaming utilities
  • flatpaks-productivity - Office tools
  • flatpaks-communication - Chat/email

System environment setup:

  • dev-environment - Full development setup
  • fonts - Extra fonts via Homebrew
  • monitoring - System monitoring (Cockpit, btop)

Cloud provider command-line tools:

  • gemini-cli - Google Gemini AI
  • firebase-cli - Firebase project management
  • wrangler - Cloudflare Workers

Container-based services (tested with cleanup):

  • jupyter - JupyterLab ML/AI environment
  • jellyfin - Media server
  • runners - GitHub Actions runners

Output Formats

Terminal Summary

Real-time pass/fail status with colored output:

Testing: ujust install pixi
  PASSED (45s)

Testing: ujust install chunkhound
  FAILED (exit code: 1)

JSON Results

Machine-readable results at ~/.cache/bazzite-ai-tests/latest/results.json:

{
  "test_run": {
    "timestamp": "2025-12-21T14:30:00+00:00",
    "total": 42,
    "passed": 38,
    "failed": 4
  },
  "results": [
    {
      "command": "pixi",
      "category": "dev-tools",
      "status": "passed",
      "duration": 45
    }
  ]
}

Pages

  • Install Test Results

    View the latest test results with pass/fail status for all commands.

    View Results

  • Command Gallery

    Watch ujust command demonstrations with asciinema recordings.

    View Commands

Requirements

  • jq - JSON processing (included in bazzite-ai OS image)
  • Overlay testing - Must be enabled via just test overlay enable