Nesta página, você encontra instruções de configuração para usar o Gemma no Colab. Algumas
também são aplicáveis a outros ambientes de desenvolvimento.
Acessar o Gemma
Antes de usar o Gemma pela primeira vez, você precisa solicitar acesso ao
por meio do Kaggle. Como parte do processo, você terá que usar um Kaggle
para aceitar a política de uso e os termos de licença do Gemma.
Se você ainda não tem uma conta Kaggle, registre-se para obter uma em
kaggle.com. Em seguida, conclua as etapas a seguir:
Preencha o formulário de consentimento e aceite os Termos e Condições.
Selecione um ambiente de execução do Colab
Para concluir um tutorial do Colab, você precisa ter um ambiente de execução do Colab com o
para executar o modelo Gemma. Para começar, faça o seguinte:
usam uma GPU T4:
No canto superior direito da janela do Colab, selecione ▾
Outras opções de conexão.
Selecione Mudar o tipo de ambiente de execução.
Em Acelerador de hardware, selecione GPU T4.
Configurar sua chave de API
Para usar o Gemma, forneça seu nome de usuário do Kaggle e uma chave de API do Kaggle. Para
gerar e configurar esses valores, siga estas etapas:
Para gerar uma chave de API do Kaggle, acesse a guia Conta do seu usuário do Kaggle
perfil e selecione Criar novo token. Isso acionará o download de um
kaggle.json que contém suas credenciais da API.
Abra kaggle.json em um editor de texto. O conteúdo deve ser semelhante a
isso:
No Colab, selecione Secrets (GoDaddy) e adicione seu nome de usuário e o nome de usuário do Kaggle.
Chave de API. Armazene seu nome de usuário com o nome KAGGLE_USERNAME e sua API
com o nome KAGGLE_KEY.
Agora está tudo pronto para você concluir as etapas de configuração restantes no Colab. Se você estiver
estiver trabalhando em um tutorial do Colab, acesse o Colab e defina as variáveis de ambiente.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-08-05 UTC."],[],[],null,["# Gemma setup\n\nThis page provides setup instructions for using Gemma in Colab. Some of the\ninstructions are applicable to other development environments as well.\n\nGet access to Gemma\n-------------------\n\nBefore using Gemma for the first time, you must request access to the\nmodel through Kaggle. As part of the process, you'll have to use a Kaggle\naccount to accept the Gemma use policy and license terms.\n\nIf you don't already have a Kaggle account, you can register for one at\n[kaggle.com](https://www.kaggle.com). Then complete the following steps:\n\n1. Go to the [Gemma model card](https://www.kaggle.com/models/google/gemma) and select **Request Access**.\n2. Complete the consent form and accept the terms and conditions.\n\nSelect a Colab runtime\n----------------------\n\nTo complete a Colab tutorial, you must have a Colab runtime with sufficient\nresources to run the Gemma model. To [get started](./get_started), you can\nuse a T4 GPU:\n\n1. In the upper-right of the Colab window, select ▾ (**Additional connection options**).\n2. Select **Change runtime type**.\n3. Under **Hardware accelerator** , select **T4 GPU**.\n\nConfigure your API key\n----------------------\n\nTo use Gemma, you must provide your Kaggle username and a Kaggle API key. To\ngenerate and configure these values, follow these steps:\n\n1. To generate a Kaggle API key, go to the **Account** tab of your Kaggle [user\n profile](https://www.kaggle.com/settings) and select **Create New Token** . This will trigger the download of a `kaggle.json` file containing your API credentials.\n2. Open `kaggle.json` in a text editor. The contents should look something like\n this:\n\n {\"username\":\"your_username\",\"key\":\"012345678abcdef012345678abcdef1a\"}\n\n3. In Colab, select **Secrets** (🔑) and add your Kaggle username and Kaggle\n API key. Store your username under the name `KAGGLE_USERNAME` and your API\n key under the name `KAGGLE_KEY`.\n\n | **Note:** Kaggle notebooks have a key storage feature under **Add-ons** \\\u003e **Secrets**, along with instructions for accessing stored keys.\n\nNow you're ready to complete the remaining setup steps in Colab. If you're\nworking through a Colab tutorial, go to Colab and set the environment variables.\n| **Tip:** As an alternative to setting environment variables, you can use `kagglehub` to [authenticate](https://github.com/Kaggle/kagglehub?tab=readme-ov-file#authenticate)."]]