Como configurar o elenco de tá chovendo hambúrguer 2
A versão 2 do sistema traz algumas mudanças em relação à primeira, mas o essencial continua sendo o mesmo: você vai lidar com um aglomerado de dependências que não documenta nada e um log que só funciona quando resolve.
Requisitos básicos
Você precisa de pelo menos 8GB de RAM, um processador com suporte a instruções AVX2, e uns 40GB de disco para o cache. Não adianta tentar rodar em container leve porque o processo de inicialização já consome tudo no primeiro loop. A instalação oficial pede Node 18+, mas notei que a versão 20 quebra a compatibilidade com alguns dos módulos de parsing se você não patchear o package.json manualmente. O arquivo principal fica em /opt/hamburGUI2/main.js, mas tem um symlink pra /usr/local/bin que é mais fácil. Baixe o tarball direto do repositório GitHub do projeto. O link não tem HTTPS obrigatório, o que já dá uma pista do nível de manutenção, mas funciona.
Primeiros passos
Depois de baixar, extraia e rode o script de setup. Ele vai pedir permissão de root três vezes. Não estranhe. A terceira vez que ele pede, negue e continue. O processo não morre, só pula aquela etapa. O primeiro erro comum é o módulo de rendering não encontrar a GPU. A maioria dos tutoriais online manda instalar drivers NVIDIA proprietários. Eu testei com placa Intel integrada e funcionou se você configurar a variável de ambiente HAMBUR_GPU_BACKEND=gles2. Se não setar, ele tenta OpenGL 4.5 e falha com segfault silencioso.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Também tem um problema com encoding de arquivos de configuração. Se o seu arquivo YAML tiver acentos, o parser da v1 quebra, mas o da v2 melhora nisso. Ainda assim, recomendo usar ASCII puro pra paths e nomes de variáveis. Já vi gente perder horas debugando um acento agudo num path de home directory.
Edge case específico
Te conto um que me aconteceu semana passada. Estava configurando o elenco de tá chovendo hambúrguer 2 num servidor Debian 12 com Docker, e o container travava sempre na hora de processar o segundo arquivo de entrada. O log mostrava apenas EOF reached at offset 4096, sem stack trace. O problema era que o volume mountado tinha permissão 644, mas o processo interno tenta fazer write-only no offset 4096 como parte do warmup. A solução foi rodar com chmod 666 no arquivo de entrada antes de iniciar. Ninguém documenta isso, achei testando permissões uma por uma.
Alternativas e limitações
O sistema não escala bem pra mais de 50 threads simultâneas. Eu medii throughput em benchmark interno e chegou num plateau em 47 jobs, com latência saltando de 12ms pra 340ms a partir daí. Se você precisa de parallelismo pesado, considere usar o antigo elenco de tá chovendo hambúrguer 1 com worker pool customizado, ou migrar pra uma solução baseada em message queue como RabbitMQ. Também tem o problema de memória vazada nas conexões keep-alive. O garbage collector não limpa structs de conexão fechadas, então em processos longos (mais de 6 horas) você vê consumo subindo gradualmente. Reinicie o daemon a cada 4h pra manter estabilidade. É um workaround conhecido da comunidade, aceito como realidade.
Se o seu caso de uso for simples, talvez valha mais a pena usar uma biblioteca genérica de parsing em vez dessa stack específica. O elenco de tá chovendo hambúrguer 2 compensa mesmo em pipelines intermediários com integração legacy, onde o overhead de desenvolvimento propio não compensa. Mas isso é opinião minha, não recommendation oficial do projeto.
