Guia Oficial de Instalação Local • Versão 2.0

Como instalar e executar o CloneVox Studio em outro computador

Siga as instruções abaixo para baixar o pacote de dependências portátil hospedado no Backblaze B2. A instalação é 100% automatizada e não exige conhecimentos técnicos.

Baixar Pacote de Dependências (.ZIP)

Tamanho: ~0.95 MB

Armazenamento: Backblaze B2

Instalação: ~60 segundos

Instalação 1-Clique

Script automático que baixa o Python portátil via uv e configura o ambiente sem intervenção manual.

FFmpeg Embutido

Motor de codificação de áudio e vídeo integrado. Não exige configuração de variáveis de ambiente no Windows.

100.000 Créditos

Licença criptografada com 100.000 créditos iniciais. Cada vídeo sincronizado consome apenas 5 créditos.

Interface Web Integrada

Frontend React já pré-compilado. Inicia na porta 7860 e abre automaticamente no seu navegador padrão.

Passo a Passo de Instalação

Siga estas 4 etapas sequenciais para rodar o CloneVox Studio no seu computador.

Baixar o Pacote ZIP no Backblaze B2

Clique no botão de download abaixo para baixar o arquivo compactado oficial diretamente dos servidores de alta velocidade do Backblaze B2.

Arquivo Oficial CloneVox_Studio_Dependencias.zip

Download Direto

Extrair o Conteúdo do Arquivo ZIP

Após o término do download, clique com o botão direito no arquivo CloneVox_Studio_Dependencias.zip e selecione "Extrair Tudo...".

Dica de Organização: Recomendamos extrair para uma pasta de fácil acesso, como C:\CloneVoxStudio ou diretamente em sua Área de Trabalho.

Executar INSTALAR_DEPENDENCIAS.bat

Abra a pasta extraída e dê dois cliques no arquivo INSTALAR_DEPENDENCIAS.bat.

O que este script executa automaticamente:

• Verifica ou baixa o instalador ultra-rápido UV (Astral)

• Cria o ambiente virtual isolado (.venv) com Python 3.10

• Instala bibliotecas de áudio, IA e servidor FastAPI

• Ativa os binários estáticos do FFmpeg para processamento de vídeo

Iniciar o Sistema via INICIAR_SISTEMA.bat

Com as dependências instaladas, basta dar dois cliques no arquivo INICIAR_SISTEMA.bat.

Endereço de Acesso Local http://localhost:7860

Abre no Navegador

O que fazer se o Windows SmartScreen exibir um aviso?

Como os arquivos .bat foram baixados recentemente da internet sem um certificado comercial pago da Microsoft, o Windows Defender pode exibir uma tela azul informando que "O Windows protegeu o seu computador".

1. Clique no link sublinhado "Mais informações".

2. Em seguida, clique no botão "Executar assim mesmo".

Esse procedimento é padrão no Windows para scripts de instalação local automatizados e é 100% seguro.

Requisitos do Sistema

Compatibilidade recomendada para execução estável

Sistema Operacional Windows 10 ou Windows 11 (64-bit)

Processador Intel Core i5 / AMD Ryzen 5 ou superior

Memória RAM 8 GB recomendado (mínimo 4 GB)

Placa de Vídeo (GPU) NVIDIA GeForce GTX/RTX com CUDA (opcional, opera em CPU)

Conexão à Internet Necessária para validação da licença e créditos no Supabase

Dúvidas Frequentes (FAQ)

Respostas diretas para as perguntas mais comuns

Preciso instalar o Python ou Node.js antes?

Não. O instalador automático (INSTALAR_DEPENDENCIAS.bat) baixa o Python portátil gerenciado via UV e o frontend React já vem pré-compilado na pasta. Você não precisa instalar nada manualmente.

Como funciona o controle de créditos da minha assinatura?

O arquivo vox_license.enc já vem ativado no pacote com 100.000 créditos iniciais. Cada vídeo gerado (ou corte seco) desconta atomicamente 5 créditos no servidor seguro Supabase. Ao zerar os créditos, a geração é pausada até a recarga com a empresa.

Posso compartilhar a pasta com outro computador?

Não. A licença utiliza vinculação física ao computador (Hardware Fingerprint Binding). Ao ser aberta no primeiro PC, a licença é vinculada exclusivamente a essa máquina. Se a pasta for transferida para outro computador, o servidor bloqueia o acesso por segurança.