ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
ODS OSS Launch Checklist
Date: 2026-03-02 Historical scope: March 2026 Strix Halo development checkout.
Archived checklist, not a current release gate. The completed/open labels
below describe the original work session. Root and product license files and
.env.example now exist. Current release acceptance is documented in
Release Validation, the support matrix,
and the September promotion record.
Do not execute old workaround or launch instructions as a current runbook.
Completed This Session
- Fix FLUX background download shell block in
install.sh(robust env/quoting fornohup bash -c). - Fix Phase C test parser error in
tests/test-phase-c-p1.sh(quote-safe regex). - Add installer capability profile contract and loader wiring:
- Add capability-aware preflight and machine-readable reporting:
- Add backend runtime contracts and loader:
- Upgrade Windows/macOS installer stubs to MVP flows:
installers/windows.ps1(WSL delegation)installers/macos.sh(doctor/preflight)
- Add ODS Doctor diagnostics report:
- Add one-command installer simulation harness:
scripts/simulate-installers.sh- Outputs:
artifacts/installer-sim/summary.json,artifacts/installer-sim/SUMMARY.md
- Add launch-claim truth table:
P0: Must Fix Before OSS Launch
- Unify compose expectations across tests/scripts/docs ✅ Completed (2026-03-02)
- Why: This repo uses
docker-compose.base.yml+ GPU overlays, but some tests/scripts had stale fallbacks. - Evidence:
tests/integration-test.sh:92tests/test-bootstrap-mode.sh:27(retired 2026-10-04; compose validation runs in.github/workflows/validate-compose.yml)scripts/upgrade-model.sh:202
- Owner: Core Maintainer
- Effort: M (0.5-1.5 days)
- Exit criteria: CI/test scripts pass against Strix compose or support both compose files.
- Add and validate
.env.examplefor reproducible installs ✅ Completed (2026-03-02)
- Why: Tests expect it; migration script references it; the file was missing at the original review.
- Evidence:
- Owner: Core Maintainer
- Effort: S (1-3 hours)
- Exit criteria:
.env.examplecommitted and referenced variables validated by tests.
- Fix stale/missing doc links and path references ✅ Completed (2026-03-03)
- Why: README/Quickstart had stale workflow references.
- Owner: Docs Maintainer
- Effort: S (1-2 hours)
- Exit criteria: no broken local links in top-level docs.
- Add license file in this publishable repo root ✅ Completed (2026-03-02)
- Why: the original checkout advertised Apache 2.0 before its license file was added. Current component terms are described in Licensing.
- Owner: Maintainer/Legal
- Effort: S (<1 hour)
- Exit criteria:
LICENSEpresent and matches stated license.
- Run launch smoke tests on a machine with Docker available
- Why, at the original review: the work environment had no Docker CLI/daemon, so those observations did not verify runtime readiness.
- Evidence:
scripts/ods-preflight.shreports Docker not running.scripts/ods-test.sh --quickfails early (docker not installed).
- Owner: Release Engineer
- Effort: S-M (2-4 hours)
- Exit criteria: preflight + quick test pass on target host.
P1: Strongly Recommended Before/Right After Launch
- Split NVIDIA vs Strix docs or add clear command matrix
- Why: mixed instructions (legacy llama-server and current
llama-server:8080) create operator confusion. - Evidence:
- Owner: Docs Maintainer
- Effort: M (0.5-1 day)
- Modernize old
docker-composecommand style in docs
- Why: docs mix
docker-composeanddocker compose; standardizing reduces support friction. - Evidence:
- Owner: Docs Maintainer
- Effort: S (1-2 hours)
- Refactor tests to mode-aware compose selection
- Why: tests are currently tuned for legacy
docker-compose.ymllayouts. - Evidence:
tests/integration-test.shtests/test-bootstrap-mode.sh(retired 2026-10-04)
- Owner: QA/Infra
- Effort: M-L (1-2 days)
- Add CI workflow for shell lint + test script syntax
- Why: catches regressions like quoting/parser breaks pre-merge.
- Owner: QA/Infra
- Effort: M (0.5-1 day)
Suggested Launch Gate
Ship only after all P0 items are complete and the following command set is green on target hardware:
./scripts/ods-preflight.sh
./scripts/ods-doctor.sh
./scripts/ods-test.sh --quick
bash tests/test-phase-c-p1.sh