GUÍA DE PROVEEDOR
Google Gemini
Ejecuta Gemini CLI como agente en segundo plano en tu máquina. CTRL NODE despacha tareas a través del Bridge usando el protocolo ACP — tus archivos permanecen locales, la salida se transmite en vivo.
Clave API o login por CLI Protocolo ACP Configuración automática de carpetas de confianza
Requisitos
- ✓ Gemini CLI instalada:
npm i -g @google/gemini-cli - ✓ Modo suscripción — login por navegador vía
gemini auth login. Incluye nivel gratuito, no requiere clave API. - ✓ Modo clave API — clave API de Google AI desde aistudio.google.com.
- ✓ CTRL NODE Bridge instalado en tu máquina (GitHub)
Inicio rápido
Opción A — Login con cuenta de Google
RecomendadoRequiere la Gemini CLI — incluye nivel gratuito, no requiere clave API.
$npm install -g @google/gemini-cli
$gemini auth login # autenticar una vez
$ PAIRING_TOKEN=your-pairing-token ./ctrlnode
Opción B — Clave API de Google AI
$ PAIRING_TOKEN=your-pairing-token \
GEMINI_API_KEY=AIza… \
./ctrlnode
GEMINI_API_KEY=AIza… \
./ctrlnode
Obtén tu clave en aistudio.google.com.
Archivo .env
PAIRING_TOKEN=your-pairing-token
# Modo login por navegador — sin clave API tras gemini auth login
# O: modo clave API
GEMINI_API_KEY=AIza…
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
| GEMINI_API_KEY | No* | Clave API de Google AI. No es necesaria si usaste gemini auth login. |
Cómo el Bridge despacha tareas a Gemini
Cuando CTRL NODE despacha una tarea a un agente de Gemini:
- El Bridge se conecta al servidor ACP de la Gemini CLI que corre localmente en tu máquina.
- Registra el workspace del agente como carpeta de confianza (configuración automática en el primer uso).
- Las instrucciones de la tarea se envían como una nueva sesión de Gemini. La salida se transmite en vivo.
- Al finalizar, el estado de la tarea se actualiza en el panel de CTRL NODE.