Como instalar o Zero no macOS, Linux e Windows

Instalação em uma linha

O caminho mais rápido para conseguir o Zero é o script oficial:

curl -fsSL https://zerolang.ai/install.sh | bash

O script baixa um compilador pré-compilado para a sua plataforma e coloca tudo em ~/.zero/. O binário em si vai parar em ~/.zero/bin/zero. Nada é escrito fora do seu diretório de usuário — sem sudo, sem mudanças no sistema.

Se preferir inspecionar o script antes de rodar, baixe sem direcionar para o shell:

curl -fsSL https://zerolang.ai/install.sh -o zero-install.sh
less zero-install.sh
bash zero-install.sh

É boa higiene para qualquer instalação curl | bash, e ainda mais para um projeto experimental.

Adicione o Zero ao seu PATH

O script de instalação te avisa do próximo passo, mas vale repetir. Adicione ~/.zero/bin ao seu PATH para conseguir rodar zero a partir de qualquer diretório:

export PATH="$HOME/.zero/bin:$PATH"

Para tornar permanente, coloque a mesma linha no arquivo de inicialização do shell que você usa:

• zsh (padrão no macOS moderno): ~/.zshrc
• bash: ~/.bashrc (Linux) ou ~/.bash_profile (macOS antigo)
• fish: adicione fish_add_path $HOME/.zero/bin em ~/.config/fish/config.fish

Depois de editar o arquivo, abra uma janela nova de terminal ou rode source ~/.zshrc (ou equivalente) para que o novo PATH entre em vigor na sessão atual.

Verifique a instalação

Em um terminal limpo, pergunte ao Zero qual é a versão:

zero --version

Você deve ver uma string de versão. Se aparecer command not found, o binário ainda não está no PATH — confira a linha de export acima e veja se ~/.zero/bin/zero realmente existe:

ls -l ~/.zero/bin/zero

Se o arquivo estiver faltando, rode o script de instalação de novo e observe a saída em busca de erros.

Notas por plataforma

macOS

Em um macOS recente (Apple Silicon ou Intel), o script de instalação "simplesmente funciona" com o zsh padrão. Na primeira vez que rodar zero, talvez você precise liberar a execução no Gatekeeper — Ajustes do Sistema → Privacidade e Segurança → "Permitir mesmo assim". Depois desse único clique, ele roda normalmente.

Linux

O script tem como alvo distribuições baseadas em glibc. Testado em Ubuntu, Debian e derivadas do Arch. Em um contêiner mínimo você pode precisar de curl e um runtime de C funcionando; instale-os com o seu gerenciador de pacotes antes de rodar o script.

Windows (via WSL2)

Não existe instalador nativo para Windows hoje. O caminho suportado é o WSL2:

1. Instale o WSL2 com wsl --install no PowerShell (como administrador).
2. Escolha uma distribuição Linux na Microsoft Store (Ubuntu serve).
3. Abra o novo shell Linux e rode o comando curl de instalação por lá.

Binários do Zero construídos no WSL2 são executáveis Linux. Você consegue rodá-los dentro do WSL2 e chamá-los do Windows pelo interop do WSL, mas não dá pra distribuir como arquivos .exe nativos.

Atualizar o Zero

A forma mais simples de atualizar é rodar o mesmo script de instalação de novo. Ele sobrescreve os binários existentes em ~/.zero/bin. Como Zero é pré-1.0, espere mudanças incompatíveis a cada versão — fixe localmente uma versão funcional se você está compartilhando uma base de código.

Desinstalando

Dois passos:

rm -rf ~/.zero

Depois, remova a linha export PATH="$HOME/.zero/bin:$PATH" do arquivo de configuração do shell. A instalação não escreve em nenhum outro lugar, então isso já é o suficiente para remover o Zero por completo.

Uma palavra sobre confiança

Zero é um software pré-1.0 de um projeto de pesquisa da Vercel. O time recomenda explicitamente rodar em ambientes isolados — uma máquina de desenvolvimento em sandbox, um contêiner, uma VM — e não na sua máquina principal de trabalho se você lida com dados sensíveis. O script de instalação é curto e vale a leitura antes de executar, ainda mais enquanto o projeto continua mudando.

A seguir: Hello, World

Com a toolchain instalada e o zero --version funcionando, você está pronto para compilar seu primeiro programa. Hello, World percorre a escrita, a execução e a dissecação de um arquivo .0 mínimo.