Rodando o projeto do curso de Deploy localmente

Use esta página para executar o projeto Dream Catcher extraído no seu computador e obter uma interpretação de sonho com sua própria chave OpenAI. Sua cópia mantém os sonhos em um de dois bancos de dados: um arquivo SQLite que vem dentro da pasta, ou um banco de dados PostgreSQL que você conecta. A maioria da configuração é igual para ambos; a versão PostgreSQL precisa de mais algumas linhas, marcadas abaixo.

O que você precisa primeiro

Instale uma versão LTS suportada do Node.js. Node 24 é recomendado e inclui npm.

Verifique se ambos os comandos funcionam. Seus números de versão podem ser diferentes:

$ node --version
v24.18.0
$ npm --version
11.18.0

Você também precisa de uma chave de API da OpenAI, porque o servidor pede à OpenAI uma interpretação para cada sonho. A chave fica no servidor, em um arquivo no seu computador, e nunca chega ao navegador.

Depois descubra qual versão você tem. Abra um terminal na pasta Dream Catcher extraída, aquela que contém package.json e server.js, e liste seus arquivos:

$ cd caminho-para-sua-pasta-dream-catcher
$ ls
README.md          package.json
config             public
dreams.db          routes
hint.md            server.js
package-lock.json  utils

Se a lista inclui dreams.db, você tem a versão SQLite: o banco de dados é esse arquivo, e não há nada mais para configurar. Se não há dreams.db, você tem a versão PostgreSQL, e também precisa de um banco de dados PostgreSQL e sua string de conexão, uma URL que começa com postgresql:// ou postgres://. Um banco de dados hospedado é a escolha mais simples, como aquele que você configurou no Render para o deploy do curso. Os bancos de dados gratuitos do Render expiram 30 dias após serem criados, então se o seu já se foi, crie um novo.

Ignore o README.md na pasta. Ele descreve uma versão antiga do app, com um provedor de IA diferente e porta diferente.

JunoO que você precisa primeiro Verifique que node --version e npm --version imprimem uma versão, e tenha uma chave de API OpenAI pronta.

Depois execute ls na pasta do projeto. Se você vê dreams.db, não precisa de mais nada; se não, você também precisa de uma URL de banco de dados PostgreSQL.

JunoO que você precisa primeiro Um servidor Express faz tudo aqui: envia a página para seu navegador, lê e escreve no banco de dados, e chama OpenAI. As duas versões diferem apenas em config/database.js, que abre dreams.db em uma e conecta a DATABASE_URL na outra.

JunoO que você precisa primeiro O navegador só chama as rotas /api/dreams deste servidor, e o cliente OpenAI é criado dentro do servidor, então nada copia a chave para código que o navegador baixa. package.json concorda com a verificação de arquivo: sqlite3 em uma versão, pg na outra.

Instale os pacotes

No mesmo terminal, instale as versões exatas que o projeto lista em seu lockfile:

$ npm ci

npm termina dizendo quantos pacotes foram adicionados. Também imprime avisos sobre pacotes descontinuados, vulnerabilidades e allow-scripts. Nenhum deles impede o projeto; deixe como estão.

JunoInstale os pacotes Execute npm ci na pasta que contém package.json, e espere pela linha que diz quantos pacotes foram adicionados.

Os avisos depois dela são esperados. Se npm diz que não consegue encontrar package.json, você está na pasta errada.

JunoInstale os pacotesnpm ci instala exatamente o que package-lock.json registra e recusa mudá-lo, então você obtém os mesmos pacotes que o curso usou. Na versão SQLite também baixa o driver SQLite compilado para seu computador.

JunoInstale os pacotessqlite3 é um módulo nativo, então seu script de instalação baixa uma compilação para seu sistema operacional e processador. É por isso que node_modules copiado de outro computador falha ao carregar, e por que npm nomeia sqlite3 em seu aviso allow-scripts.

Faça npm start ler seu arquivo .env

O servidor lê suas configurações de process.env, mas o comando start do projeto não carrega um arquivo .env, então o servidor iniciaria sem sua chave e pararia imediatamente. Abra package.json e altere:

"start": "node server.js"

para:

"start": "node --env-file=.env server.js"

Node agora lê .env em si, uma vez, antes de o código do servidor executar. Se o arquivo estiver faltando, Node para com node: .env: not found.

Depois abra .gitignore. Deve listar .env, então Git nunca salva sua chave, e node_modules. Na versão SQLite, a segunda linha está com a grafia errada mode_modules; corrija para que leia:

node_modules
.env

Mantenha as linhas logs e *.log que já estão lá. O manual Git explica por que essas entradas importam em ignorando arquivos e boas práticas.

JunoFaça npm start ler seu arquivo .env Em package.json, adicione --env-file=.env ao script start. Depois verifique que .gitignore lista node_modules e .env, com a grafia exata.

JunoFaça npm start ler seu arquivo .env No Scrimba e em um host como Render, as configurações já estão no ambiente quando o servidor inicia. No seu computador elas vivem em um arquivo, e --env-file é a forma nativa de Node para carregá-lo, sem pacote extra.

JunoFaça npm start ler seu arquivo .env Uma variável já definida em seu shell vence sobre o mesmo nome em .env. Se você já exportou OPENAI_API_KEY neste terminal, aquele valor antigo é o que o servidor recebe.

Adicione seu .env e inicie

Crie um arquivo chamado .env ao lado de package.json. A versão SQLite precisa apenas da linha chave; a versão PostgreSQL também precisa da linha DATABASE_URL:

# Apenas versão PostgreSQL
DATABASE_URL=postgresql://usuario:senha@host:5432/database

OPENAI_API_KEY=sua-chave-openai-aqui

Para PostgreSQL, substitua a URL de exemplo inteira pela que seu host fornece para conectar de fora de sua própria rede (no Render, a URL externa no menu Connect do banco de dados). O servidor usa gpt-4o-mini e porta 3001 a menos que você adicione linhas OPENAI_MODEL ou PORT para escolher outros.

Inicie o servidor:

$ npm start
Server running on http://localhost:3001

A versão PostgreSQL primeiro imprime Database initialized: ela se conecta ao banco de dados e cria sua tabela antes de começar a escutar, então Server running aparece apenas uma vez que o banco de dados respondeu. Se o terminal imprime Failed to initialize database: em vez disso, o servidor parou; a resolução de problemas abaixo combina com o erro depois dele. Na versão PostgreSQL, você também pode abrir http://localhost:3001/health; uma conexão funcionando responde com JSON que inclui "status":"ok" e "db":"connected".

Abra http://localhost:3001. A página mostra Add a New Dream e, sob Your Dream Journal, "No dreams yet", porque ambos os bancos de dados começam vazios. Descreva um sonho e clique Get Interpretation. O botão lê Interpreting... enquanto OpenAI escreve, e depois seu sonho aparece no diário com sua interpretação.

Se a interpretação falhar, a página mostra um erro: "Network error. Please check your connection and try again." na versão SQLite, que mostra essa mensagem para toda falha, ou "AI service temporarily unavailable." na versão PostgreSQL. De qualquer forma, olhe para o terminal, não sua conexão. O motivo segue OpenAI API error:, acima de um bloco longo de detalhes; a resolução de problemas abaixo combina com cada um.

Pare o servidor com Ctrl+C. Node lê .env apenas quando o servidor inicia, então reinicie após qualquer alteração em .env. A versão PostgreSQL ainda tem a rota de teste /shutdown da lição, que para o servidor quando aberta; delete antes de fazer deploy.

JunoAdicione seu .env e inicie Coloque sua chave, e para PostgreSQL sua URL de banco de dados, em .env. Execute npm start, aguarde Server running, e abra http://localhost:3001. Adicione um sonho e clique Get Interpretation.

Se a página mostra um erro, leia o terminal: o motivo está impresso lá.

JunoAdicione seu .env e inicie Ver a página prova que Express a está servindo e o banco de dados abriu. A interpretação é o primeiro momento que o servidor chama OpenAI, então um novo sonho no diário é o que prova que sua chave funciona.

JunoAdicione seu .env e inicie O app.js da versão SQLite lê uma variável data indefinida quando o servidor responde com um erro, então o ReferenceError cai em seu catch de erro de rede. O pool PostgreSQL sempre pede uma conexão criptografada; um servidor PostgreSQL no seu próprio computador geralmente tem criptografia desligada, então pg para com The server does not support SSL connections.

Resolução de problemas

OpenAIError: The OPENAI_API_KEY environment variable is missing or empty quando você inicia: O servidor parou antes de poder escutar; a mensagem vem logo após algumas linhas apontando para openai/index.mjs. Verifique que o script start contém --env-file=.env, que .env está ao lado de package.json, e que o nome é exatamente OPENAI_API_KEY.

node: .env: not found: O script start está correto, mas não há .env na pasta de onde você iniciou. Crie ao lado de package.json.

401 Incorrect API key provided: A chave chegou à OpenAI, mas OpenAI não a aceitou. Copie novamente de sua conta OpenAI, salve .env, e reinicie o servidor.

429 You exceeded your current quota: A chave funciona, mas a conta não tem crédito para gastar. Adicione crédito em Billing em sua conta OpenAI, depois tente novamente.

The model ... does not exist: OpenAI planeja desligar gpt-4o-mini em 14 de janeiro de 2027. Depois disso, adicione uma linha OPENAI_MODEL a .env com o substituto que a página de descontinuações da OpenAI nomeia, e reinicie.

Error: Could not locate the bindings file (versão SQLite): O driver SQLite para seu computador está faltando. Delete node_modules e execute npm ci novamente nesta pasta. Não copie node_modules de outro computador.

Failed to initialize database: com ENOTFOUND: O nome do host em DATABASE_URL não existe em sua rede. Verifique que você substituiu a URL de exemplo inteira, e que você copiou a URL externa, não uma interna que funciona apenas dentro da rede do seu host.

Failed to initialize database: com ECONNREFUSED: Nada respondeu naquele endereço. Se o erro nomeia a porta 5432 no seu próprio computador (::1 ou 127.0.0.1), DATABASE_URL está faltando em .env ou aponta para um PostgreSQL que não está executando.

Failed to initialize database: com password authentication failed: O nome de usuário ou senha em DATABASE_URL está errado. Copie a URL novamente de seu host de banco de dados.

Failed to initialize database: com The server does not support SSL connections: Você está usando um servidor PostgreSQL sem criptografia, geralmente um no seu próprio computador. Para uso local apenas, adicione ?sslmode=disable ao final de DATABASE_URL, ou use um banco de dados hospedado em vez disso.

JunoResolução de problemas Leia o terminal, não a página. Encontre a primeira linha contendo Error e combine suas palavras com um título em negrito acima. Depois corrija .env ou o arquivo nomeado, e execute npm start novamente.

JunoResolução de problemas Cada problema aparece em seu próprio momento: uma chave faltando ou .env assim que você inicia, um problema de banco de dados antes de Server running, e um problema de chave, crédito ou modelo apenas quando você clica Get Interpretation.

JunoResolução de problemas O cliente OpenAI é construído enquanto server.js importa suas rotas, então uma chave faltando para Node antes de qualquer linha de server.js executar. Uma chave errada passa nessa verificação e falha apenas na primeira requisição, com um 401.