Ir para o conteúdo
Promovaweb
Projeto open source da Promovaweb

Edições do SetupVibe

Uma edição para cada máquina

O computador usado para escrever código e o servidor que executa uma aplicação precisam de ferramentas diferentes. O SetupVibe reúne quatro edições para preparar esses ambientes. A escolha começa pelo sistema instalado e pelo trabalho que você pretende fazer nessa máquina.

  • Edição Desktop do SetupVibe, para macOS, Linux e WSL2
  • Edição Windows do SetupVibe, para Windows 11, versão Beta
  • Edição Server do SetupVibe, para Servidores de produção
  • Edição Omarchy do SetupVibe, para Omarchy 4 em x86_64

SetupVibe Desktop

Seu computador ou VPS de desenvolvimento

Ao começar um projeto, você precisa executar a aplicação e acompanhar os erros no terminal. No macOS, em um Linux compatível, no WSL2 ou numa VPS onde você faz Vibe Coding e roda agentes de IA remotos, a Desktop Edition instala e configura o shell e as ferramentas de desenvolvimento. O shell interpreta os comandos que você digita. Os runtimes executam as linguagens usadas pela aplicação.

Exemplo de uso

Por exemplo, em um projeto Laravel, o PHP executa o código e o Composer instala as dependências declaradas em composer.json. Depois de preparar a máquina, php --version e composer --version mostram se esses comandos estão disponíveis no terminal. A configuração do banco de dados e as dependências da aplicação ainda precisam ser conferidas no projeto.

Bom saber

No Windows, esse percurso atende ao trabalho dentro de uma distribuição Linux no WSL2. O WSL2 permite usar esse ambiente Linux junto ao Windows. Para preparar ferramentas diretamente no PowerShell, consulte a Windows Edition (Beta).

O que vem instalado

  • Homebrew
  • PHP, Composer e Laravel
  • Ruby, Go, Rust e Python
  • Node.js 24, Bun e PNPM
  • Docker, Ansible e GitHub CLI
  • Zsh, Oh My Zsh e Starship
  • Tmux e plugins TPM
  • CLIs de IA e PM2

Requisitos

macOS 12+, Linux (computador ou VPS de desenvolvimento) e WSL

SetupVibe Windows

Seu computador com Windows 11, versão Beta

Você pode trabalhar com ferramentas de desenvolvimento no próprio Windows 11. A Windows Edition (Beta) usa PowerShell para instalar utilitários e preparar Python, Node.js e as CLIs de IA compatíveis. Uma CLI é uma ferramenta usada por comandos no terminal. A edição preserva os perfis do PowerShell. Antes de instalar essa versão Beta, confira as limitações documentadas.

Exemplo de uso

Por exemplo, para executar um script JavaScript no Windows, você precisa que o comando node esteja disponível. Depois da instalação, abra um novo terminal e use node --version para conferir o runtime. Para um script Python, python --version verifica o interpretador instalado. Esses testes mostram as versões disponíveis, sem executar uma aplicação sua.

Bom saber

A edição também instala a base do WSL2, sem acrescentar uma distribuição Linux. Para desenvolver dentro do Ubuntu no WSL2, você ainda precisa preparar essa distribuição e seguir o percurso Desktop. Escolha conforme o terminal no qual pretende trabalhar.

O que vem instalado

  • WinGet e Chocolatey
  • Python 3.14 e Node.js 24 LTS
  • Claude Code, Codex CLI e Antigravity CLI
  • Base do WSL 2, sem distribuição
  • OpenSSH e Windows Terminal
  • Perfis do PowerShell preservados

Requisitos

Windows 11 22H2+ (build 22621+), x64

SetupVibe Server

Aplicações em produção

Ao colocar aplicações em produção num servidor Linux, você precisa acessar o terminal e acompanhar serviços e containers. A Server Edition prepara esse servidor em Ubuntu, Debian e Zorin OS compatíveis. Se a máquina remota serve para programar ou rodar agentes de IA, use a Desktop Edition. O SSH permite acessar o terminal pela rede. Os containers executam aplicações com suas dependências, enquanto o Docker permite acompanhar seu estado.

Exemplo de uso

Por exemplo, depois de acessar um servidor que usa Docker, docker ps lista os containers em execução. A lista ajuda a identificar o nome e o estado de cada container. Ela não confirma, por si só, que uma aplicação responde corretamente. Para investigar uma falha, confira também os logs e teste o endereço da aplicação.

Bom saber

A instalação possui uma opção para iniciar o Docker Swarm Manager. O Swarm organiza serviços em um conjunto de máquinas Docker. A criação desse conjunto depende da configuração de rede e do endereço escolhido para o servidor. O comando correspondente fica na página de instalação.

O que vem instalado

  • Docker, Ansible e GitHub CLI
  • Node.js 24 via APT
  • Zsh, Oh My Zsh e Starship
  • Tmux e plugins TPM
  • CLIs de IA e Herdr
  • Rede, monitoramento e Tailscale

Requisitos

Ubuntu 24.04+, Debian 12+ e Zorin OS 18+

SetupVibe Omarchy

Seu Omarchy 4 em x86_64

Uma instalação existente do Omarchy 4 já fornece shell, tmux, Docker e ferramentas de desenvolvimento. A edição Omarchy do SetupVibe acrescenta sua configuração sobre esse ambiente e preserva os componentes fornecidos pelo sistema. Use esse percurso para adicionar as ferramentas do SetupVibe ao Omarchy em uma máquina x86_64.

Exemplo de uso

Por exemplo, para trabalhar com Laravel, você pode precisar do Composer além das ferramentas que já usa no Omarchy. A edição acrescenta ferramentas como PHP e Composer conforme o que estiver ausente. Depois da instalação, command -v composer mostra onde o terminal encontra o comando. Em seguida, composer --version permite conferir a versão disponível.

Bom saber

As configurações próprias do SetupVibe ficam em ~/.config/setupvibe/. Essa separação ajuda a localizar os arquivos acrescentados sem confundi-los com os arquivos do Omarchy. Confira o guia da edição para saber quais componentes são preservados e quais ferramentas são adicionadas.

O que vem instalado

  • Instala só os pacotes ausentes
  • Usa omarchy pkg add
  • Preserva shell, aliases e tmux do Omarchy
  • Configurações em ~/.config/setupvibe

Requisitos

Omarchy 4 sobre Arch Linux, x86_64, com sudo

Compare o que cada edição instala

A edição é escolhida pelo papel da máquina. Para programar, inclusive numa VPS com agentes de IA, use o Desktop. Para rodar aplicações em produção, use o Server.

O que cada edição do SetupVibe instala
DesktopSeu computador ou VPS de desenvolvimentoWindowsSeu computador com Windows 11, versão BetaServerAplicações em produçãoOmarchySeu Omarchy 4 em x86_64
PHP, Ruby, Go, Rust e PythonInstalaSó PythonNão instalaInstala
Node.js, Bun e PNPMInstalaSó Node.jsSó Node.jsInstala
DockerInstalaNão instalaInstalaJá vem no Omarchy
Ansible e GitHub CLIInstalaSó GitHub CLIInstalaAnsible
Zsh, Oh My Zsh e StarshipInstalaNão instalaInstalaSó Starship
tmuxInstalaNão instalaInstalaJá vem no Omarchy
Agentes de IA e HerdrInstalaSem HerdrInstalaCompleta os do Omarchy
TailscaleInstalaInstalaInstalaInstala
Servidor SSHNo LinuxOpenSSHInstalaNão instala
WSL 2Não instalaSem distribuiçãoNão instalaNão instala
Docker Swarm ManagerNão instalaNão instalaCom --managerNão instala