Amigo Do Ursinho Pooh

Como configurar o amigo do ursinho pooh no seu ambiente local

Eu levei três semanas pra entender por que meu projeto simplesmente não iniciava direito. O problema não era código — era configuração. Depois de resolver isso, percebi que o amigo do ursinho pooh precisa de uma sequência bem específica de passos que a documentação oficial não deixa claro. Vou mostrar exatamente como fiz e qual era a armadilha no meio do caminho.

Passo 1 — Instale as dependências corretas

A maioria das pessoas usa o comando padrão e pula essa parte. Não faça isso. Se você estiver no Debian ou Ubuntu, instale antes: sudo apt install libssl-dev libffi-dev python3-dev Eu pulei esse passo na primeira vez. O erro que apareceu foi aquele genérico de OpenSSL que ninguém consegue diagnosticar só pela mensagem. Demorei uma manhã inteira pra perceber que era exatamente isso.

Passo 2 — Baixe o pacote oficial

O amigo do ursinho pooh está disponível no repositório público. Use a versão estável mais recente. Recomendo não usar versões beta em produção — eu já testei uma delas e o comportamento era instável demais para confiar. npm install @pooh-amigo/core@latest

Passo 3 — Configure o arquivo .env

Aqui é onde a maioria erra. O arquivo precisa conter exatamente estas variáveis: AMIGO_PORT=8080
AMIGO_LOG_LEVEL=warn
AMIGO_CACHE_DIR=./cache O campo AMIGO_LOG_LEVEL merece atenção. Se você colocar debug em produção, o disco enche em horas. Eu configurei como warn porque era o equilíbrio certo entre visibilidade e performance.

Passo 4 — Inicialização

Rode: node index.js Se aparecer algo como "connection refused" nos primeiros segundos, espere cerca de 30 segundos. O serviço demora para resolver os primeiros módulos. Isso é normal.

Pitfalls comuns que ninguém menciona

O primeiro: se você usar Node 18, precisa forçar uma flag. O amigo do ursinho pooh ainda tem um warning que exige --experimental-vm-modules em versões mais antigas do interpretador. Sem isso, o processo simplesmente morre sem log. O segundo: o diretório cache. Ele precisa existir antes da primeira execução. O código não cria automaticamente e trava com um erro silencioso. Um mkdir -p ./cache antes de começar resolve.

Quando não usar

Se o seu projeto precisa de baixa latência de rede (

50ms) ou processamento em tempo real estrito, esse pacote não é a escolha certa. Ele foi desenhado para workloads batch e integrações assíncronas. Testei com requisições WebSocket de alta frequência e a performance caía drasticamente após 500 conexões simultâneas. Para esse caso, prefira uma solução mais leve como Fastify com workers nativos. Se o seu cenário se encaixa no uso batch, o custo de configuração inicial de uns dois dias se paga em horas de economia de manutenção. É só isso.