Menu
Test voxtype in Docker containers. Use for testing builds, verifying packages work on different distros, or isolating test environments.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
| name | docker-test |
| description | Test voxtype in Docker containers. Use for testing builds, verifying packages work on different distros, or isolating test environments. |
| user-invocable | true |
| allowed-tools | ["Bash","Read","Glob"] |
Test voxtype builds and packages in isolated Docker containers.
Uses Ubuntu 22.04 to avoid AVX-512 instruction contamination:
./scripts/build-docker.sh
Output: releases/${VERSION}/voxtype-${VERSION}-linux-x86_64-avx2
Uses remote Docker context (pre-AVX-512 CPU) for clean build:
./scripts/build-docker-vulkan.sh
Output: releases/${VERSION}/voxtype-${VERSION}-linux-x86_64-vulkan
VERSION=0.4.14 docker compose -f docker-compose.build.yml build --no-cache avx2 vulkan
VERSION=0.4.14 docker compose -f docker-compose.build.yml up avx2 vulkan
# Build test container
docker run -it --rm -v $(pwd)/releases:/releases ubuntu:22.04 bash
# Inside container:
apt update && apt install -y /releases/0.4.14/voxtype_0.4.14-1_amd64.deb
voxtype --version
voxtype --help
# Fedora
docker run -it --rm -v $(pwd)/releases:/releases fedora:latest bash
# Inside container:
dnf install -y /releases/0.4.14/voxtype-0.4.14-1.x86_64.rpm
voxtype --version
docker run -it --rm ubuntu:22.04 bash -c "
apt update &&
apt install -y curl libasound2 &&
curl -L https://github.com/peteonrails/voxtype/releases/download/v0.4.14/voxtype-0.4.14-linux-x86_64-avx2 -o /usr/bin/voxtype &&
chmod +x /usr/bin/voxtype &&
voxtype --version
"
docker run -it --rm fedora:latest bash -c "
dnf install -y alsa-lib curl &&
curl -L https://github.com/peteonrails/voxtype/releases/download/v0.4.14/voxtype-0.4.14-linux-x86_64-avx2 -o /usr/bin/voxtype &&
chmod +x /usr/bin/voxtype &&
voxtype --version
"
docker run -it --rm archlinux:latest bash -c "
pacman -Sy --noconfirm base-devel git &&
# Test AUR package build
git clone https://aur.archlinux.org/voxtype-bin.git &&
cd voxtype-bin &&
makepkg -si --noconfirm
"
For builds requiring a pre-AVX-512 CPU:
# List contexts
docker context ls
# Switch to remote build server
docker context use truenas
# Build clean binaries
docker compose -f docker-compose.build.yml up avx2 vulkan
# Switch back to local
docker context use default
Build cache issues:
docker compose -f docker-compose.build.yml build --no-cache
Container won't start: Check if audio devices are needed - voxtype requires ALSA/PipeWire which may not be available in containers.
Version mismatch after build:
Docker cached old layers. Always use --no-cache for release builds.
Based on SOC occupation classification
Build all voxtype binaries for release. Builds Whisper (AVX2, AVX-512, Vulkan) and ONNX (AVX2, AVX-512, CUDA) binaries using Docker. Use when preparing a new release.
Run regression tests for voxtype releases. Use before major releases to verify core functionality, CLI commands, and configuration handling.
Run interactive smoke tests for voxtype. Tests recording cycles, CLI overrides, signal handling, and service management. Use after installing a new build.
Triage a GitHub issue or PR by checking for duplicates, documentation alignment, project fit, and recommending labels.
Publish voxtype to AUR. Updates PKGBUILD, generates checksums, and pushes to AUR. Use after a GitHub release is published.
Package voxtype for release. Creates deb and rpm packages from binaries. Use when building distribution packages.
