← Back to Skills Marketplace
wangminrui2022

purevocals-uvr-automator

by 顶尖王牌程序员 · GitHub ↗ · v1.0.5 · MIT-0
cross-platform ⚠ suspicious
245
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install purevocals-uvr-automator
Description
当用户想要**一键批量从音频文件中提取超干净纯人声(干声 / Vocals Only)**、去除伴奏/背景音乐时,自动调用此技能。 一键音频人声分离工具。专门从音频文件(.mp3/.wav/.flac等)中提取超干净干声(Acapella)或去除背景音制作伴奏。 核心用途:支持单个音频文件或整个文件夹批量处理(....
Usage Guidance
What to consider before installing/using this skill: - Legitimate purpose but surprising side effects: the code does implement vocal extraction, GPU detection and model downloads, but it also runs pip at runtime and (on import) force-reinstalls setuptools/wheel in the current Python, which can modify your system or other projects unexpectedly. - Network downloads & large files: it will download ffmpeg and ML models (hundreds of MB to GB) from external URLs and PyTorch wheels from pytorch.org. Expect big network/ disk usage and possible firewalls/slowdowns. - Persistent artifacts: models/, logs/, and a venv directory (VENV_DIR) are created on disk. VENV_DIR appears to be outside the skill folder and may be shared — check its path before running. - Privileged operations: the script invokes subprocesses (pip, nvidia-smi, ffmpeg-downloader, audio-separator CLI) and may run long installs and re-launch itself inside a created venv. Practical recommendations: - If you want to try it, run it first in a sandboxed environment: a disposable VM, container, or an isolated user account where side effects are acceptable. - Inspect and/or modify the code before running: move the setuptools fix/any pip installs into an explicit, documented setup step (not at module import), or require user confirmation before modifying the global Python environment. - Prefer manual venv: change VENV_DIR to a skill-local venv (inside the skill folder) or let the user supply the venv path. Verify that package installs occur inside that venv, not the global interpreter. - Monitor network and disk: be ready for large downloads and ensure you have sufficient storage and bandwidth. Consider pre-downloading models to models/ and set offline usage. - If you need higher assurance: ask the author for a version that avoids global pip calls at import time and documents all external downloads and paths it will write to. Confidence note: medium — the code clearly performs the operations described, but some behaviors (top-level pip/setuptools change, shared venv location) may be legitimate design choices for convenience; they are nonetheless risky and under-documented.
Capability Analysis
Type: OpenClaw Skill Name: purevocals-uvr-automator Version: 1.0.5 The skill automates audio vocal separation by managing a complex environment, including automatic virtual environment creation, GPU detection, and the installation of heavy dependencies like PyTorch and audio-separator. It performs high-risk operations such as force-reinstalling specific versions of 'setuptools', downloading 'ffmpeg' binaries via 'ffmpeg-downloader', and fetching AI models from GitHub (TRvlvr/model_repo). While these actions are aligned with the stated purpose of providing a 'one-click' solution, the automated execution of third-party installers and binary downloads via 'subprocess' in scripts/env_manager.py and scripts/purevocals.py constitutes a significant attack surface without evidence of intentional malice.
Capability Assessment
Purpose & Capability
技能名/描述与代码主逻辑(调用 audio-separator、检测 GPU、下载模型、批量处理音频)一致。但 ensure_package.fix_setuptools() 在模块导入时立即调用,会在当前 Python 解释器环境中强制安装/降级 setuptools 和 wheel —— 这一行为与“只是运行本地音频分离”不可预期,且会修改宿主环境。VENV_DIR 指向技能目录之外的路径(可能是共享 venv),这也没有在文档中充分说明。
Instruction Scope
SKILL.md 指示以 python scripts/purevocals.py 启动,文档说明了模型下载和 venv 管理,但未明确说明代码会在首次导入时修改当前 Python 环境(立即执行 pip install/setuptools 强制重装)、会自动下载外部二进制(ffmpeg)并从网络拉取大模型文件。这些 side-effect 在文档中没有明确提示或征得用户同意。
Install Mechanism
技能没有平台 install spec,但代码在运行时通过 pip 安装/升级多个包(包括对 PyTorch 的大型 wheel 下载、audio-separator、ffmpeg-downloader 等),并自动从外部源下载 ffmpeg 与模型文件。运行时从网络下载安装与解包会写入磁盘并执行二进制/大型包,属于较高风险操作且没有在 SKILL.md 中充分警告。
Credentials
技能不要求任何秘密或外部凭证(没有 env var 要求),这与用途相符. 然而,代码会尝试访问系统工具(nvidia-smi)、修改 Python 包(在导入时降级 setuptools)并在技能外部路径创建/使用虚拟环境与 models/logs 目录。这些资源访问没有在文档中明确解释,可能影响其他 Python 项目或技能。
Persistence & Privilege
always:false (正常)。但脚本会在磁盘上长期写入模型、日志与虚拟环境,且可能创建一个位于技能上级的共享 venv,从而产生持久改变。没有修改其他技能配置的代码,但全局 pip 更改(setuptools 重装)和共享 venv 是持久且有潜在影响的权限级别。
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install purevocals-uvr-automator
  3. After installation, invoke the skill by name or use /purevocals-uvr-automator
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
No changes detected in this version (1.0.5). - No file modifications or updates found. - Functionality and description remain unchanged.
v1.0.4
Version 1.0.4 - No file changes detected in this release. - Functionality and documentation remain unchanged.
v1.0.3
PureVocals-UVR-Automator 1.0.3 - Improved and expanded skill description for broader scenarios, highlighting both acapella extraction and accompaniment removal. - Added clearer usage examples and typical trigger phrases to support better natural language invocation. - Clarified supported models and their recommended use cases. - Stated the tool's batch processing, folder structure preservation, and automation features more explicitly. - No code or functional changes were made in this version.
v1.0.2
PureVocals-UVR-Automator 1.0.2 - Updated script command examples to remove the "./skills/purevocals-uvr-automator/" path prefix, simplifying usage. - No changes to functionality or features.
v1.0.1
- Default recommended vocal separation model changed to shibing624-chinese-kenlm-klm (from Kim_Vocal_2.onnx). - No other changes detected.
v1.0.0
Initial release of PureVocals-UVR-Automator: - Batch-extracts ultra-clean vocals from audio files (supports .mp3, .wav, .flac, etc.). - Includes support for multiple models (Kim_Vocal_2.onnx as default, karaoke-focused, and speed-optimized options). - Automatically detects GPU for CUDA acceleration, manages virtual environments, and preserves original folder structure. - Outputs results in WAV format, with customizable options for model, window size, aggression, and more. - Easy one-command usage from directory or file input; auto-creates output folder when not specified.
Metadata
Slug purevocals-uvr-automator
Version 1.0.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is purevocals-uvr-automator?

当用户想要**一键批量从音频文件中提取超干净纯人声(干声 / Vocals Only)**、去除伴奏/背景音乐时,自动调用此技能。 一键音频人声分离工具。专门从音频文件(.mp3/.wav/.flac等)中提取超干净干声(Acapella)或去除背景音制作伴奏。 核心用途:支持单个音频文件或整个文件夹批量处理(.... It is an AI Agent Skill for Claude Code / OpenClaw, with 245 downloads so far.

How do I install purevocals-uvr-automator?

Run "/install purevocals-uvr-automator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is purevocals-uvr-automator free?

Yes, purevocals-uvr-automator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does purevocals-uvr-automator support?

purevocals-uvr-automator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created purevocals-uvr-automator?

It is built and maintained by 顶尖王牌程序员 (@wangminrui2022); the current version is v1.0.5.

💬 Comments