Instalación de Gemini CLI

La instalación de Gemini CLI es el primer paso para interactuar con los servicios de Gemini desde tu terminal. Esta lección detalla el proceso de descarga, configuración inicial y verificación, asegurando que tu entorno esté listo para el desarrollo y la gestión de proyectos.

Requisitos del Sistema

Antes de proceder con la instalación, es fundamental verificar que tu entorno cumpla con los requisitos mínimos. Gemini CLI está diseñado para funcionar en los sistemas operativos más comunes, pero la versión de Python y las dependencias del sistema operativo son críticas para una operación estable. No cumplir con estos requisitos puede llevar a errores de instalación o a un comportamiento inesperado durante el uso.

• Sistema Operativo: Linux (distribuciones basadas en Debian/RPM), macOS (Intel y Apple Silicon), Windows (versiones de 64 bits).
• Python: Versión 3.8 o superior. Es recomendable usar la última versión estable compatible para aprovechar mejoras de seguridad y rendimiento. Verifica tu versión con python3 --version.
• Memoria RAM: Mínimo 4 GB. Para proyectos grandes o uso intensivo de Code Assist, se recomiendan 8 GB o más.
• Espacio en Disco: Mínimo 2 GB de espacio libre para la instalación y almacenamiento de cachés. El espacio requerido puede aumentar con el tamaño de los proyectos y las dependencias.
• Conexión a Internet: Necesaria para la descarga inicial, actualizaciones y para la interacción con los servicios de Google Cloud.

Proceso de Instalación

La instalación de Gemini CLI se realiza principalmente a través de pip, el gestor de paquetes de Python. Este método asegura que todas las dependencias se resuelvan automáticamente. Los pasos varían ligeramente según el sistema operativo, pero la lógica subyacente es la misma.

1. Paso 1: Crear y activar un entorno virtual. En tu directorio de proyecto, ejecuta: python3 -m venv gemini-env source gemini-env/bin/activate (Linux/macOS) .\gemini-env\Scripts\activate (Windows PowerShell)
2. Paso 2: Instalar Gemini CLI. Una vez activado el entorno virtual, instala el paquete: pip install google-gemini-cli Este comando descargará e instalará la última versión estable del CLI junto con sus dependencias.
3. Paso 3: Verificar la instalación. Para confirmar que Gemini CLI se instaló correctamente y es accesible desde tu PATH, ejecuta: gemini --version Si la instalación fue exitosa, este comando mostrará la versión actual del CLI. Si recibes un error de 'comando no encontrado', verifica que el entorno virtual esté activo y que el PATH del sistema incluya el directorio de ejecutables del entorno virtual.

Configuración Inicial (Opcional pero Recomendado)

Aunque la funcionalidad básica de Gemini CLI no requiere una configuración inicial extensa, establecer ciertos parámetros puede mejorar la experiencia de uso. Estos ajustes suelen estar relacionados con la ubicación de archivos de configuración o la definición de un proyecto predeterminado. Por ahora, nos centraremos en la verificación de la instalación.

# Ejemplo de verificación de PATH (Linux/macOS)
which gemini

# Ejemplo de PATH (Windows)
Get-Command gemini | Select-Object Path

El comando which gemini (o Get-Command gemini en Windows) te mostrará la ruta completa al ejecutable de Gemini CLI. Esto es útil para diagnosticar problemas de PATH si el comando gemini no es reconocido.

Resolución de Problemas Comunes

Durante la instalación, pueden surgir algunos inconvenientes. Aquí se detallan los más frecuentes y sus soluciones:

• 'Command not found' o 'gemini is not recognized': Asegúrate de que tu entorno virtual esté activo. Si estás en Windows, verifica que la ruta al script de activación sea correcta. En Linux/macOS, confirma que el PATH del shell incluye el directorio bin de tu entorno virtual.
• Errores de permisos: Si encuentras errores relacionados con permisos al instalar con pip, evita usar sudo pip install. En su lugar, verifica los permisos de tu directorio de usuario o, mejor aún, asegúrate de estar dentro de un entorno virtual, donde los permisos de escritura son inherentes.
• Problemas con la versión de Python: Si tienes múltiples versiones de Python instaladas, asegúrate de estar usando la versión 3.8 o superior para crear el entorno virtual y ejecutar pip. Puedes especificar la versión con python3.8 -m venv gemini-env.
• Conexión de red: Si la descarga falla, verifica tu conexión a internet o la configuración de tu proxy si estás en una red corporativa. pip respeta las variables de entorno HTTP_PROXY y HTTPS_PROXY.

Aplicación Práctica: Preparando tu Entorno para la Autenticación

Para el lunes, tu tarea es asegurar que Gemini CLI esté correctamente instalado y verificado en tu máquina de desarrollo. Esto implica:

1. Verificar los requisitos del sistema: Confirma que tu versión de Python sea adecuada y que tengas suficiente espacio en disco.
2. Instalar Gemini CLI en un entorno virtual: Sigue los pasos detallados para crear un entorno virtual, activarlo e instalar el CLI. No omitas el uso del entorno virtual.
3. Verificar la instalación: Ejecuta gemini --version para confirmar que el CLI está operativo y muestra su versión. Si encuentras errores, consulta la sección de resolución de problemas.

Tener el CLI instalado y funcionando es la base para la siguiente lección, donde abordaremos la autenticación y autorización, que son críticas para interactuar con los servicios de Google Cloud.