webcode-local-windows-tts-installer

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.

Jump to install

Repository: shuyu-labs/WebCode
Last source activity: May 6, 2026 at 04:08
Detected SKILL.md language: English
Stars: 284
Forks: 41

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

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\