Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ctrlnode.ai/llms.txt

Use this file to discover all available pages before exploring further.

Provider id: gemini · CtrlNode agent type: Gemini Runs the @google/gemini-cli through ACP on stdio.

​
When to use it

  • You want Google Gemini models for coding tasks from CtrlNode
  • You use gemini locally or on a VPS with API access

​
Prerequisites

  • Node.js 20+
  • Gemini CLI:
npm install -g @google/gemini-cli
gemini --version

​
Authentication

Option A — API key 
GEMINI_API_KEY=AIza...
Option B — Google login 
gemini auth login

​
Environment variables

VariableDefaultDescription
GEMINI_API_KEY—Google AI / Gemini API key
GEMINI_TIMEOUT_MINUTES10Task timeout
AGENTS_FOLDERHomeWorkspace root

​
Example .env

PAIRING_TOKEN=...
PROVIDERS=gemini
GEMINI_API_KEY=AIza...

​
CtrlNode setup

  1. Project agent type Gemini
  2. Register agents in Team
  3. Pick model in the agent editor when the Bridge reports available models

​
Troubleshooting

IssueFix
CLI not foundInstall globally; add ~/.local/bin to PATH on Linux
Auth errorsgemini auth login or valid GEMINI_API_KEY
Empty model listAPI key optional for dispatch; key helps model listing
← All providers