Ir para o conteúdo

Primeiros passos

Primeiros passos

Como instalar e executar o Vukem Video, e o que você pode fazer hoje enquanto ele está na fase BETA.

Última atualização:

O que você pode fazer hoje#

  • Importar mídia, cortá-la e organizá-la em uma linha do tempo, adicionar texto e legendas e exportar um MP4 verificado.
  • Salvar um projeto como modelo e iniciar novos projetos a partir dele.
  • Deixar um agente fazer o mesmo pelo servidor MCP ou pela CLI.
  • Ler os documentos de planejamento no repositório: requisitos, decisões de arquitetura e especificações.

Instalar#

O produto roda apenas na sua máquina. Cada versão traz:

  • instaladores do servidor local, que instalam o vukem-video e um atalho que inicia o servidor e abre o editor no navegador; desinstalar remove o programa e mantém o seu espaço de trabalho:
    • Windows 11: vukem-video_<version>_windows_amd64_setup.exe
    • Debian e Ubuntu: vukem-video_<version>_linux_<arch>.deb
    • qualquer Linux: vukem-video_<version>_linux_amd64.AppImage
    • macOS: vukem-video_<version>_darwin_<arch>.pkg
  • arquivos compactados para seis plataformas e o checksums.txt, assinado com cosign.

A imagem de contêiner da versão web é iniciada com um comando deste formato, que publica a porta apenas no seu computador:

Terminal
docker run --rm -p 127.0.0.1:7878:7878 -v vukem-video:/data \
  -e APP_KEY="$(openssl rand -base64 32)" \
  ghcr.io/alexgalhardo/vukem-video:<version>

O servidor escuta em 127.0.0.1:7878 e só pode ser acessado a partir do seu computador. Abra esse endereço no navegador para chegar ao editor. Seus projetos e mídias ficam no volume vukem-video, então um novo contêiner com o mesmo volume os encontra de novo. A página de instalação traz os detalhes da imagem e das suas tags.

Windows SmartScreen e macOS Gatekeeper#

Os instaladores não são assinados com um certificado pago de assinatura de código, então os dois sistemas avisam antes da primeira execução.

  • Windows. O SmartScreen mostra "O Windows protegeu seu PC" para o .exe. Escolha "Mais informações" e depois "Executar assim mesmo".
  • macOS. O Gatekeeper diz que o pacote não pode ser aberto porque a Apple não consegue verificá-lo. Clique com Control no .pkg e escolha Abrir, ou permita em Ajustes do Sistema, Privacidade e Segurança.

Para conferir um download antes de executá-lo, verifique o checksums.txt com o cosign e compare o SHA-256 do arquivo, como descrito na política de segurança.

Para uma pessoa#

  1. Inicie o servidor (vukem-video serve).
  2. Abra http://127.0.0.1:7878 no navegador, ou execute vukem-video open.

Para um agente#

Escolha uma entre três rotas para o mesmo projeto:

  1. O servidor MCP por stdio: o comando é vukem-video mcp.
  2. A CLI com --json, por exemplo vukem-video project:create --name "Launch teaser" --json.
  3. A API HTTP do vukem-video serve, com MCP por Streamable HTTP em POST /mcp.

Essas rotas compartilham o mesmo conjunto de operações, então um agente e uma pessoa veem o mesmo resultado. A visão geral para agentes mostra como conectar um.

Próximos passos#

Volte para a introdução.