GeminiCode: un asistente de programación basado en Gemini 2.5 que funciona en terminales

Introducción general

GeminiCode es un asistente de programación con inteligencia artificial que se ejecuta en un terminal, desarrollado por desarrolladores en su tiempo libre los fines de semana. Se basa en el Géminis 2.5 Pro que lee y modifica archivos en el directorio actual de su ordenador. Esta herramienta se inspira en Antrópico (utilizado como expresión nominal) Claude Code, el objetivo es proporcionar a los programadores un asistente para utilizar directamente desde la línea de comandos. Se trata de un proyecto experimental, no es software para entornos de producción, y puede tener errores, por lo que los usuarios deben utilizarlo con precaución. El desarrollador sugiere utilizarlo sólo en entornos de prueba o en directorios sin importancia para evitar manipular archivos sensibles.

Lista de funciones

• Leer archivo: Lee automáticamente el contenido de todos los archivos del directorio y subdirectorios actuales.
• modificar un documento: Se pueden crear, editar o borrar archivos para cambiar el código directamente en el directorio.
• ejecutar un comando: Puede ejecutar el comando bash en un terminal para realizar operaciones sencillas.
• generación de código: Genera código basado en la entrada del usuario, como escribir una función.
• Soporte de depuración: Ayuda a analizar los mensajes de error y ofrece sugerencias para solucionarlos.

Utilizar la ayuda

GeminiCode es una herramienta de línea de comandos que necesita ser instalada y ejecutada en un terminal. A continuación se detallan los pasos y las instrucciones para que pueda empezar a utilizarla rápidamente. Nota: Accederá directamente a los archivos de tu directorio actual sin pedir permisos explícitos, así que asegúrate de que tu directorio es seguro antes de usarlo.

Proceso de instalación

1. Creación de un entorno virtual
   Abra un terminal e introduzca el siguiente comando para crear un entorno Python aislado para evitar interferencias con otros proyectos:

python3 -m venv venv
source venv/bin/activate

Después de ejecutar el segundo comando, el terminal mostrará (venv)que indica que el entorno se ha activado correctamente.

2. Instalación de GeminiCode
   Introducido en un entorno virtual:

pip install gemini-code

Esto descargará e instalará la última versión desde PyPI. El proceso de instalación suele tardar entre unos segundos y un minuto, dependiendo de la velocidad de la red.

3. Configuración de la clave API
   Necesitas una clave API de Google para utilizar el modelo Gemini. Para obtenerla: visite https://ai.google.dev/Regístrese y genere la clave. A continuación, introdúcela en el terminal:

gemini setup YOUR_GOOGLE_API_KEY

intercambiabilidad YOUR_GOOGLE_API_KEY para su clave real. Después de la configuración correcta, la herramienta será capaz de conectarse al modelo.

4. iniciar una sesión
   Introduzca el siguiente comando para empezar:

gemini

Si se le indica que falta un módulo questionaryCorre:

pip install questionary

O especifique la puesta en marcha del modelo:

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

Al iniciarse, el terminal entra en modo interactivo.

funcionamiento básico

1. Ver las fichas del catálogo
   Introdúcelo en la sesión:

What files are in this directory?

La herramienta listará todos los archivos del directorio actual, como por ejemplo main.pyyreadme.txt.

2. Generar código
   Las entradas son similares:

Create a simple Python function that calculates the Fibonacci sequence

La herramienta genera el código y lo muestra, por ejemplo:

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

Puedes copiar a un archivo o dejar que la herramienta escriba directamente.

3. modificar un documento
   Entrada:

Add a print statement to main.py

Se leerá main.pyAñadir print("Hello")y, a continuación, guardar. Nota: No hay paso de confirmación para modificar el archivo directamente.

4. código de depuración
   Pega el mensaje de error, por ejemplo:

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

La herramienta analiza y recomienda la definición de variables x.

5. ejecutar un comando
   Entrada:

Run ls command

Ejecutará el comando bash y devolverá el resultado (sólo admite comandos simples).

6. cerrar sesión (informática)
   Entrada:

/exit

La sesión termina y vuelve al terminal normal.

Precauciones de uso

• Solicitar limitaciones25 solicitudes al día para la versión gratuita, 100 para el nivel 1. Cuando se supera, pasa al modelo 1.5 Pro, pero puede ser inestable.
• Recomendaciones de seguridad: Utilícelo sólo en el directorio de prueba y haga copias de seguridad de los archivos importantes. Puede ejecutarse en contenedores como Docker para aumentar el aislamiento.
• problemas comunesSi se bloquea, reinicie la sesión. Consulte la ayuda de /help.

Con estos pasos, puede utilizar GeminiCode en el terminal. es adecuado para tareas de programación experimental, pero no es lo suficientemente estable para el desarrollo formal.

escenario de aplicación

1. Código de prueba rápida
   Quieres probar a escribir una pequeña función, como una calculadora. Puede utilizar GeminiCode para generar el código en el directorio de prueba y comprobarlo manualmente antes de ejecutarlo.
2. Aprender a depurar
   Los programadores noveles que se encuentren con mensajes de error que no puedan entender pueden pegarlos en GeminiCode para obtener explicaciones sencillas y sugerencias sobre cómo cambiarlos.
3. Operaciones con archivos temporales
   Necesita modificar el contenido de un archivo de forma masiva, como añadir comentarios. Utilice GeminiCode para introducir los comandos y termínelo en segundos.

CONTROL DE CALIDAD

1. ¿Es seguro GeminiCode?
   No es completamente seguro. Opera directamente sobre ficheros sin mecanismos de protección. Se recomienda utilizarlo sólo en directorios sin importancia y hacer copias de seguridad de los datos importantes.
2. ¿Necesito trabajar en red?
   Sí, el tiempo de ejecución requiere una conexión a Internet para llamar a la API de Google.
3. ¿Qué tipos de archivos son compatibles?
   puede leer cualquier archivo de texto, como .pyy.txtpero diseñado principalmente para el código.
4. ¿Qué pasa si sobrepaso el límite de solicitudes?
   1,5 Los modelos Pro se utilizan automáticamente tras superar el límite y su funcionalidad puede verse limitada. Te recomendamos esperar al día siguiente o actualizar tu cuenta.