GeminiCode: um assistente de programação de IA baseado no Gemini 2.5 em execução em terminais

Introdução geral

O GeminiCode é um assistente de programação de IA que é executado em um terminal, desenvolvido por desenvolvedores em seu tempo livre nos fins de semana. Ele é baseado no Gêmeos 2.5 Pro que lê e modifica arquivos no diretório atual de seu computador. Essa ferramenta é inspirada em Antrópica (usado em uma expressão nominal) Claude Code, o objetivo é fornecer aos programadores um assistente para ser usado diretamente na linha de comando. É um projeto experimental, não é um software para ambientes de produção e pode ter bugs, portanto, os usuários devem usá-lo com cautela. O desenvolvedor sugere usá-lo somente em ambientes de teste ou em diretórios sem importância para evitar a manipulação de arquivos confidenciais.

Lista de funções

• Ler arquivoLeitura automática do conteúdo de todos os arquivos no diretório e subdiretórios atuais.
• modificar um documentoArquivos: Os arquivos podem ser criados, editados ou excluídos para alterar diretamente o código no diretório.
• executar um comandoComando bash: Você pode executar o comando bash em um terminal para realizar operações simples.
• geração de códigoGerar código com base na entrada do usuário, como escrever uma função.
• Suporte à depuraçãoAjuda a analisar mensagens de erro e a dar sugestões para corrigi-las.

Usando a Ajuda

O GeminiCode é uma ferramenta de linha de comando que precisa ser instalada e executada em um terminal. Abaixo estão as etapas e instruções detalhadas para garantir que você comece a usar rapidamente. Observação: ele acessará diretamente os arquivos em seu diretório atual sem solicitações explícitas de permissão, portanto, certifique-se de que seu diretório seja seguro antes de usá-lo.

Processo de instalação

1. Criação de um ambiente virtual
   Abra um terminal e digite o seguinte comando para criar um ambiente Python isolado para evitar interferir em outros projetos:

python3 -m venv venv
source venv/bin/activate

Depois de executar o segundo comando, o terminal exibirá (venv)indicando que o ambiente foi ativado com êxito.

2. Instalando o GeminiCode
   Entrou em um ambiente virtual:

pip install gemini-code

Isso fará o download e instalará a versão mais recente do PyPI. O processo de instalação geralmente leva de alguns segundos a um minuto, dependendo da velocidade da rede.

3. Configuração da chave de API
   Você precisa de uma chave de API do Google para usar o modelo Gemini. Para obtê-la: visite https://ai.google.dev/registre-se e gere a chave. Em seguida, insira-a no terminal:

gemini setup YOUR_GOOGLE_API_KEY

intercambialidade YOUR_GOOGLE_API_KEY para sua chave real. Após a configuração bem-sucedida, a ferramenta poderá se conectar ao modelo.

4. iniciar uma sessão
   Digite o seguinte comando para iniciar:

gemini

Se for solicitado um módulo ausente questionaryExecutar:

pip install questionary

Ou especifique a inicialização do modelo:

gemini --model models/gemini-2.5-pro-exp-03-25

Ao ser inicializado, o terminal entra no modo interativo.

operação básica

1. Exibir arquivos do catálogo
   Registre-o na sessão:

What files are in this directory?

A ferramenta listará todos os arquivos no diretório atual, como main.pyereadme.txt.

2. Gerar código
   As entradas são semelhantes:

Create a simple Python function that calculates the Fibonacci sequence

A ferramenta gera o código e o exibe, por exemplo:

def fibonacci(n):
if n <= 1:
return n
return fibonacci(n-1) + fibonacci(n-2)

Você pode copiar para um arquivo ou permitir que a ferramenta grave diretamente.

3. modificar um documento
   Entrada:

Add a print statement to main.py

O texto será main.pyAdicionar print("Hello")e, em seguida, salve. Observação: Não há etapa de confirmação para modificar o arquivo diretamente.

4. código de depuração
   Cole a mensagem de erro, por exemplo:

Help me debug this error message: NameError: name 'x' is not defined

A ferramenta analisa e recomenda a definição de variáveis x.

5. executar um comando
   Entrada:

Run ls command

Ele executará o comando bash e retornará o resultado (somente comandos simples compatíveis).

6. Fazer logout (computação)
   Entrada:

/exit

A sessão termina e retorna ao terminal normal.

Precauções de uso

• Limitações da solicitaçãoNível 1: 25 solicitações por dia para a versão gratuita, 100 para o Nível 1. Quando excedido, ele muda para o modelo 1.5 Pro, mas pode ser instável.
• Recomendações de segurançaUse-o somente no diretório de teste e faça backup dos arquivos importantes. Pode ser executado em contêineres como o Docker para aumentar o isolamento.
• problemas comunsSe ele travar, basta reiniciar a sessão. Consulte a ajuda com /help.

Com essas etapas, você pode usar o GeminiCode no terminal. Ele é adequado para tarefas de programação experimental, mas não é estável o suficiente para o desenvolvimento formal.

cenário do aplicativo

1. Código de teste rápido
   Você deseja testar a gravação de uma pequena função, como uma calculadora. Você pode usar o GeminiCode para gerar o código no diretório de teste e verificá-lo manualmente antes da execução.
2. Aprendendo a depurar
   Os programadores iniciantes que encontrarem mensagens de erro que não conseguem entender podem colá-las no GeminiCode para obter explicações simples e sugestões sobre como alterá-las.
3. Operações de arquivos temporários
   Você precisa modificar o conteúdo de um arquivo em massa, como adicionar comentários. Use o GeminiCode para inserir os comandos e concluí-los em segundos.

QA

1. O GeminiCode é seguro?
   Não é totalmente seguro. Ele opera diretamente em arquivos sem mecanismos de proteção. Recomenda-se usá-lo somente em diretórios sem importância e fazer backup dos dados importantes.
2. Preciso fazer networking?
   Sim, o tempo de execução requer uma conexão com a Internet para chamar a API do Google.
3. Quais são os tipos de arquivos suportados?
   pode ler qualquer arquivo de texto, como .pye.txtmas projetado principalmente para código.
4. E se eu exceder o limite de solicitações?
   Os modelos 1.5 Pro são usados automaticamente após exceder o limite e a funcionalidade pode ser limitada. Recomendamos aguardar o dia seguinte ou fazer o upgrade de sua conta.