No README.md do projeto diz que o arquivo .env deveria ser criado automaticamente, o que não ocorreu provavelmente porque esse arquivo .env está no gitIgnore. Eu criei o .env manualmente na pasta raiz do projeto, mas não sei o que devo colocar nesse .env. Por favor, poderiam me ajudar? Muito obrigado.
Olá, Romualdo. Como vai?
Você tocou em um ponto fundamental do desenvolvimento de software moderno! O seu raciocínio está totalmente correto: o arquivo .env fica obrigatoriamente listado no .gitignore porque ele armazena dados sensíveis que nunca devem ser expostos publicamente no GitHub.
Como o curso é sobre Spec Driven Development e agentes de IA, o seu projeto precisa se comunicar com as APIs dos modelos de linguagem. O arquivo .env (de environment, ou ambiente) serve exatamente para guardar essas credenciais de acesso e chaves privadas.
Para resolver o seu problema agora e fazer o projeto funcionar, trago o passo a passo do que você deve colocar dentro dele e uma boa prática de mercado indispensável.
.env?Geralmente, projetos que utilizam agentes de IA precisam de chaves de API específicas. Abra o arquivo .env que você criou na raiz e insira as variáveis abaixo (substituindo os valores fictícios pelas suas chaves reais):
# Exemplo de chaves para os modelos de IA
OPENAI_API_KEY=sk-proj-SuaChaveSecretaDaOpenAIAqui...
GEMINI_API_KEY=AIzaSySuaChaveSecretaDoGeminiAqui...
ANTHROPIC_API_KEY=sk-ant-SuaChaveSecretaDaAnthropicAqui...
# Configurações do ambiente do projeto
PORT=3000
NODE_ENV=development
⚠️ Atenção: Não coloque espaços antes ou depois do sinal de igual (
=) e não mude o nome das variáveis (o texto antes do=deve ser exatamente o que o projeto espera ler).
.env.exampleComo o .env original está oculto pelo Git, uma das maiores boas práticas do mercado é criar um segundo arquivo na raiz chamado .env.example.
Esse arquivo não vai para o .gitignore e serve como um manual ou "molde" para que outros desenvolvedores (ou você mesmo no futuro) saibam quais variáveis o projeto precisa para rodar, sem expor as chaves reais.
A estrutura do seu .env.example deve ser assim:
# Modelo de configuração do projeto (Copie este arquivo e mude para .env)
OPENAI_API_KEY=insira_sua_chave_da_openai_aqui
GEMINI_API_KEY=insira_sua_chave_do_gemini_aqui
PORT=3000
Se o projeto que você baixou já tiver um arquivo chamado .env.example ou .env.dist, basta você duplicá-lo, renomear a cópia para apenas .env e preencher com os seus dados!
Parabéns por investigar os bastidores do projeto e resolver o problema do arquivo oculto manualmente. Esse entendimento de infraestrutura é vital para trabalhar com agentes autônomos.
Espero que possa ter lhe ajudado e bons estudos com os agentes de IA!