From a3928bf0cdf8f86df7d33bd4d8fd4c1107c32f70 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Sun, 15 Nov 2026 23:58:19 +0400 Subject: [PATCH 1/9] feat: add VoiceStudio container script --- ct/voicestudio.sh | 67 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 ct/voicestudio.sh diff --git a/ct/voicestudio.sh b/ct/voicestudio.sh new file mode 100644 index 0000000000..153e64fc2a --- /dev/null +++ b/ct/voicestudio.sh @@ -0,0 +1,67 @@ +#!/usr/bin/env bash +_CS_DEFAULT_URL="https://raw.githubusercontent.com/community-scripts/DevScripts/main" +_cs_boot="${COMMUNITY_SCRIPTS_CORE_DIR:-$(dirname "${BASH_SOURCE[0]}")/../../core}/core/build.func" +source "$_cs_boot" 2>/dev/null || source <(curl -fsSL "${COMMUNITY_SCRIPTS_CORE_URL:-https://raw.githubusercontent.com/community-scripts/core/main}/core/build.func") +# Copyright (c) 2021-2026 community-scripts ORG +# Author: Estcool9 (Estcool9) +# License: MIT | https://github.com/community-scripts/DevScripts/raw/main/LICENSE +# Source: https://github.com/debpalash/VoiceStudio + +APP="VoiceStudio" +var_tags="${var_tags:-ai;audio;tts;voice}" +var_cpu="${var_cpu:-6}" +var_ram="${var_ram:-12288}" +var_disk="${var_disk:-50}" +var_os="${var_os:-debian}" +var_version="${var_version:-13}" +var_arm64="${var_arm64:-yes}" +var_unprivileged="${var_unprivileged:-1}" + +header_info "$APP" +variables +color +catch_errors + +function update_script() { + header_info + check_container_storage + check_container_resources + + if [[ ! -d /opt/voicestudio ]]; then + msg_error "No VoiceStudio Installation Found!" + exit + fi + + if check_for_gh_release "voicestudio" "debpalash/VoiceStudio"; then + msg_info "Stopping VoiceStudio" + systemctl stop voicestudio + msg_ok "Stopped VoiceStudio" + + NODE_VERSION="22" NODE_MODULE="bun@1.4.2" setup_nodejs + PYTHON_VERSION="3.12" setup_uv + CLEAN_INSTALL=1 fetch_and_deploy_gh_release "voicestudio" "debpalash/VoiceStudio" "tarball" + + msg_info "Building VoiceStudio" + cd /opt/voicestudio + $STD bun install --frozen-lockfile + OMNIVOICE_TORCH_VARIANT=cpu $STD bun run setup:api + $STD bun run build:web + msg_ok "Built VoiceStudio" + + msg_info "Starting VoiceStudio" + systemctl start voicestudio + msg_ok "Started VoiceStudio" + msg_ok "Updated successfully!" + fi + exit +} + +start +build_container +description + +msg_ok "Completed Successfully!\n" +echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}" +echo -e "${INFO}${YW}Access it using the following URL:${CL}" +echo -e "${GATEWAY}${BGN}http://${IP}:3900${CL}" +echo -e "${INFO}${YW}API key: /opt/voicestudio_data/.env (OMNIVOICE_API_KEY). For first browser login, append #api_key= to the URL.${CL}" From c7ef911bf054de35457785c272303c2593d31837 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Sun, 15 Nov 2026 23:58:21 +0400 Subject: [PATCH 2/9] feat: add VoiceStudio bare-metal install script --- install/voicestudio-install.sh | 88 ++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 install/voicestudio-install.sh diff --git a/install/voicestudio-install.sh b/install/voicestudio-install.sh new file mode 100644 index 0000000000..68508c6c54 --- /dev/null +++ b/install/voicestudio-install.sh @@ -0,0 +1,88 @@ +#!/usr/bin/env bash + +# Copyright (c) 2021-2026 community-scripts ORG +# Author: Estcool9 (Estcool9) +# License: MIT | https://github.com/community-scripts/DevScripts/raw/main/LICENSE +# Source: https://github.com/debpalash/VoiceStudio + +source /dev/stdin <<<"$FUNCTIONS_FILE_PATH" +color +verb_ip6 +catch_errors +setting_up_container +network_check +update_os + +msg_info "Installing VoiceStudio system dependencies" +$STD apt install -y \ + build-essential \ + cmake \ + libgl1 \ + libglib2.0-0t64 \ + libopus-dev \ + libsndfile1 \ + pkg-config +msg_ok "Installed VoiceStudio system dependencies" + +setup_ffmpeg +NODE_VERSION="22" NODE_MODULE="bun@1.4.2" setup_nodejs +PYTHON_VERSION="3.12" setup_uv + +fetch_and_deploy_gh_release "voicestudio" "debpalash/VoiceStudio" "tarball" + +msg_info "Installing VoiceStudio JavaScript dependencies" +cd /opt/voicestudio +$STD bun install --frozen-lockfile +msg_ok "Installed VoiceStudio JavaScript dependencies" + +msg_info "Installing VoiceStudio CPU backend" +OMNIVOICE_TORCH_VARIANT=cpu $STD bun run setup:api +msg_ok "Installed VoiceStudio CPU backend" + +msg_info "Building VoiceStudio web interface" +$STD bun run build:web +msg_ok "Built VoiceStudio web interface" + +msg_info "Configuring VoiceStudio data and model storage" +mkdir -p /opt/voicestudio_data/huggingface +chmod 700 /opt/voicestudio_data /opt/voicestudio_data/huggingface +cat </opt/voicestudio_data/.env +OMNIVOICE_SERVER_MODE=1 +OMNIVOICE_API_KEY=$(random_password 48) +OMNIVOICE_DATA_DIR=/opt/voicestudio_data +HF_HOME=/opt/voicestudio_data/huggingface +PYTHONPATH=/opt/voicestudio/backend +PYTHONUNBUFFERED=1 +PYTHONDONTWRITEBYTECODE=1 +OMNIVOICE_ANALYTICS_DISABLED=1 +EOF +chmod 600 /opt/voicestudio_data/.env +msg_ok "Configured VoiceStudio data and model storage" + +msg_info "Creating VoiceStudio service" +cat </etc/systemd/system/voicestudio.service +[Unit] +Description=VoiceStudio Web Backend +After=network-online.target +Wants=network-online.target + +[Service] +Type=simple +WorkingDirectory=/opt/voicestudio +EnvironmentFile=/opt/voicestudio_data/.env +ExecStart=/opt/voicestudio/.venv/bin/uvicorn backend.main:app --host 0.0.0.0 --port 3900 +Restart=on-failure +RestartSec=5 +TimeoutStartSec=600 +UMask=0077 +LimitNOFILE=65535 + +[Install] +WantedBy=multi-user.target +EOF +systemctl enable -q --now voicestudio +msg_ok "Created VoiceStudio service" + +motd_ssh +customize +cleanup_lxc From 6970672fa13622de75f170421b18829bc98e1c20 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Sun, 15 Nov 2026 23:58:23 +0400 Subject: [PATCH 3/9] feat: add VoiceStudio metadata --- json/voicestudio.json | 56 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 json/voicestudio.json diff --git a/json/voicestudio.json b/json/voicestudio.json new file mode 100644 index 0000000000..d4d0555a3d --- /dev/null +++ b/json/voicestudio.json @@ -0,0 +1,56 @@ +{ + "name": "VoiceStudio", + "slug": "voicestudio", + "categories": [ + 20 + ], + "date_created": "2026-11-15", + "type": "ct", + "updateable": true, + "privileged": false, + "interface_port": 3900, + "documentation": "https://github.com/debpalash/VoiceStudio/blob/main/docs/remote-gpu.md", + "website": "https://voicestudio.sh/", + "repository": "https://github.com/debpalash/VoiceStudio", + "architectures": [ + "amd64", + "arm64" + ], + "platforms": [ + "pve" + ], + "logo": "https://cdn.jsdelivr.net/gh/debpalash/VoiceStudio@v0.5.8/docs/logo.svg", + "description": "VoiceStudio is a local-first AI voice studio for voice cloning, speech generation, dubbing, transcription and audiobooks. It provides a browser-based interface backed by a self-hosted inference service.", + "install_methods": [ + { + "type": "default", + "script": "ct/voicestudio.sh", + "config_path": "/opt/voicestudio_data/.env", + "resources": { + "cpu": 6, + "ram": 12288, + "hdd": 50, + "os": "Debian", + "version": "13" + } + } + ], + "default_credentials": { + "username": null, + "password": null + }, + "notes": [ + { + "text": "The administrator API key is stored in /opt/voicestudio_data/.env as OMNIVOICE_API_KEY. For first browser access, append #api_key= to the VoiceStudio URL; the browser exchanges it for a session.", + "type": "info" + }, + { + "text": "This installation uses CPU-only PyTorch. Speech generation can be slow with larger engines; install smaller CPU-friendly engines for better responsiveness.", + "type": "warning" + }, + { + "text": "Voice models are downloaded when selected in VoiceStudio and are stored under /opt/voicestudio_data/huggingface. Allow additional disk space for models.", + "type": "info" + } + ] +} \ No newline at end of file From d7a7a574c31e0be06325a6b7e88538159c2cb84b Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Mon, 16 Nov 2026 00:04:12 +0400 Subject: [PATCH 4/9] fix: restrict VoiceStudio LXC to amd64 --- ct/voicestudio.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ct/voicestudio.sh b/ct/voicestudio.sh index 153e64fc2a..86fb0bf2f7 100644 --- a/ct/voicestudio.sh +++ b/ct/voicestudio.sh @@ -14,7 +14,7 @@ var_ram="${var_ram:-12288}" var_disk="${var_disk:-50}" var_os="${var_os:-debian}" var_version="${var_version:-13}" -var_arm64="${var_arm64:-yes}" +var_arm64="${var_arm64:-no}" var_unprivileged="${var_unprivileged:-1}" header_info "$APP" From 86e1429ec90e01093a90e1681f39a885abb29ea3 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Mon, 16 Nov 2026 00:04:14 +0400 Subject: [PATCH 5/9] fix: align VoiceStudio system dependencies with upstream --- install/voicestudio-install.sh | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/install/voicestudio-install.sh b/install/voicestudio-install.sh index 68508c6c54..4ff48e7662 100644 --- a/install/voicestudio-install.sh +++ b/install/voicestudio-install.sh @@ -16,12 +16,7 @@ update_os msg_info "Installing VoiceStudio system dependencies" $STD apt install -y \ build-essential \ - cmake \ - libgl1 \ - libglib2.0-0t64 \ - libopus-dev \ - libsndfile1 \ - pkg-config + libsndfile1 msg_ok "Installed VoiceStudio system dependencies" setup_ffmpeg From 11db658090c9169a144472d297984f61b7c3255f Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Mon, 16 Nov 2026 00:04:16 +0400 Subject: [PATCH 6/9] fix: mark VoiceStudio architecture as amd64 --- json/voicestudio.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/json/voicestudio.json b/json/voicestudio.json index d4d0555a3d..ccc56b863a 100644 --- a/json/voicestudio.json +++ b/json/voicestudio.json @@ -13,8 +13,7 @@ "website": "https://voicestudio.sh/", "repository": "https://github.com/debpalash/VoiceStudio", "architectures": [ - "amd64", - "arm64" + "amd64" ], "platforms": [ "pve" From 76e7626a6a604889052e36d69fa7459f449dda04 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Mon, 16 Nov 2026 00:35:44 +0400 Subject: [PATCH 7/9] fix: install GnuPG before setting up Node.js --- install/voicestudio-install.sh | 1 + 1 file changed, 1 insertion(+) diff --git a/install/voicestudio-install.sh b/install/voicestudio-install.sh index 4ff48e7662..4732992624 100644 --- a/install/voicestudio-install.sh +++ b/install/voicestudio-install.sh @@ -16,6 +16,7 @@ update_os msg_info "Installing VoiceStudio system dependencies" $STD apt install -y \ build-essential \ + gnupg \ libsndfile1 msg_ok "Installed VoiceStudio system dependencies" From 28d34ea526b932c88e8cf6b34c02b079b7c5abc3 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Mon, 16 Nov 2026 01:10:15 +0400 Subject: [PATCH 8/9] Pin VoiceStudio installer to Python 3.11 --- install/voicestudio-install.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install/voicestudio-install.sh b/install/voicestudio-install.sh index 4732992624..014d521c80 100644 --- a/install/voicestudio-install.sh +++ b/install/voicestudio-install.sh @@ -22,7 +22,7 @@ msg_ok "Installed VoiceStudio system dependencies" setup_ffmpeg NODE_VERSION="22" NODE_MODULE="bun@1.4.2" setup_nodejs -PYTHON_VERSION="3.12" setup_uv +PYTHON_VERSION="3.11" setup_uv fetch_and_deploy_gh_release "voicestudio" "debpalash/VoiceStudio" "tarball" From 8a553e062f3e0d28cfc54e0005b7846aab950600 Mon Sep 17 00:00:00 2001 From: Estcool9 <111180796+Estcool9@users.noreply.github.com> Date: Mon, 16 Nov 2026 01:10:17 +0400 Subject: [PATCH 9/9] Pin VoiceStudio updater to Python 3.11 --- ct/voicestudio.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ct/voicestudio.sh b/ct/voicestudio.sh index 86fb0bf2f7..fe9b96ff66 100644 --- a/ct/voicestudio.sh +++ b/ct/voicestudio.sh @@ -38,7 +38,7 @@ function update_script() { msg_ok "Stopped VoiceStudio" NODE_VERSION="22" NODE_MODULE="bun@1.4.2" setup_nodejs - PYTHON_VERSION="3.12" setup_uv + PYTHON_VERSION="3.11" setup_uv CLEAN_INSTALL=1 fetch_and_deploy_gh_release "voicestudio" "debpalash/VoiceStudio" "tarball" msg_info "Building VoiceStudio"