| name | webcode-local-windows-tts-installer |
| description | Use when building a local Windows WebCode installer from this repo for machine testing, especially when the package must bundle the Kokoro or sherpa-onnx Reply TTS service, model files, ffmpeg, a private Python runtime, and non-system-drive deployment without publishing a GitHub Release. |
WebCode Local Windows TTS Installer
Overview
Build the local WebCode Windows installer and portable ZIP with the bundled Reply TTS payload. Use this skill for local validation and handoff artifacts, not for branch push, tag push, or GitHub Release asset sync.
For GitHub publishing, use webcode-github-release instead.
Workflow
- Confirm the current checkout is the WebCode repo, or pass
-RepoRoot.
- Prefer
Debug when the user wants to try the installer locally before cleanup. Use Release only when the user asks for release-grade artifacts.
- Run
scripts/build-local-installer.ps1 from this skill instead of reconstructing the command by hand.
- Report the generated installer, portable ZIP, checksums, and release notes from
artifacts/windows-installer/vX.Y.Z/.
- If the user asks for runtime verification, smoke-test the generated
tts-bundle by starting tools/sherpa-kokoro-service/start.ps1 against it and checking http://127.0.0.1:<port>/health.
Command
Default local build:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build-local-installer.ps1
Explicit repo root and release build:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build-local-installer.ps1 `
-RepoRoot "D:\VSWorkshop\WebCode" `
-Configuration Release
Override the TTS payload source root if autodetection picks the wrong drive:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build-local-installer.ps1 `
-ReplyTtsSourceRoot "E:\WebCodeData\Kokoro"
Rules
- Treat
Directory.Build.props as the version source of truth.
- Treat
tools/build-windows-installer.ps1 as the single source of truth for packaging behavior. Fix that script instead of adding ad hoc shell steps.
- Expect the TTS source root to be a complete payload root containing
models\kokoro-int8-multi-lang-v1_1, venv\Scripts\python.exe, and a bundled python\ directory.
- Do not rely on a target-machine Python installation. The local installer path for this workflow is the bundled private runtime plus the bundled venv.
- Do not move the TTS payload onto the Windows system drive. The installer must target a writable non-system fixed drive and fail clearly otherwise.
- If multiple non-system drives exist and autodetection chooses the wrong one, rerun with
-ReplyTtsSourceRoot.
- Expect the artifact set to be
WebCode-Setup-vX.Y.Z-win-x64.exe, WebCode-vX.Y.Z-win-x64-portable.zip, SHA256SUMS.txt, and RELEASE_NOTES.md.
Files
- Skill wrapper:
scripts/build-local-installer.ps1
- Repo build script:
<RepoRoot>\tools\build-windows-installer.ps1
- Installer definition:
<RepoRoot>\installer\windows\WebCode.iss
- TTS service payload:
<RepoRoot>\tools\sherpa-kokoro-service\
