Importante

Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!

1
resposta

Como salvar a API Key no pycharm

nao estou no google colab como salvar a chave de api em outra ide sem ser o google colab.

1 resposta

Olá, José. Como vai?

Essa é uma excelente dúvida! Quando saímos de ambientes de nuvem como o Google Colab e passamos para IDEs locais como o PyCharm, a segurança da nossa API Key se torna ainda mais importante para evitar que a chave seja exposta acidentalmente, especialmente se você pretende subir seu código para o GitHub futuramente.

Existem duas formas principais de fazer isso no PyCharm, sendo a primeira a mais recomendada para desenvolvimento local.

1. Utilizando Variáveis de Ambiente do PyCharm

Esta é a maneira mais prática e segura dentro da própria IDE:

  • No canto superior direito, clique na lista de configurações de execução (ao lado do botão de "Play") e selecione Edit Configurations....
  • Na janela que abrir, procure o campo chamado Environment variables.
  • Clique no ícone de pasta/lápis no final desse campo.
  • Adicione uma nova variável clicando no símbolo de +. No campo Name, digite algo como GEMINI_API_KEY e, no campo Value, cole a sua chave.
  • Clique em OK e Apply.

Para acessar essa chave no seu código Python, você usará a biblioteca os:

import os

api_key = os.getenv("GEMINI_API_KEY")
print(f"Chave carregada com sucesso!")

2. Utilizando um arquivo .env (Boas Práticas de Mercado)

Se você quer que seu projeto seja profissional e fácil de configurar em outras máquinas, utilize um arquivo de texto oculto:

  • Na raiz do seu projeto no PyCharm, crie um arquivo chamado exatamente .env (com o ponto no início).
  • Dentro dele, escreva: GEMINI_API_KEY=sua_chave_aqui.
  • Instale a biblioteca necessária no terminal do PyCharm: pip install python-dotenv.
  • No seu script, carregue a chave assim:
import os
from dotenv import load_dotenv

load_dotenv() # Carrega as variáveis do arquivo .env
api_key = os.getenv("GEMINI_API_KEY")

Dica importante de segurança: Se você usa o Git, nunca esqueça de adicionar o arquivo .env ao seu .gitignore. Isso garante que sua chave permaneça apenas no seu computador.

Essa organização é o que chamamos de separação entre código e configuração, uma das bases da engenharia de software.

Espero que possa ter lhe ajudado!