MQL5-Google-Onedrive/docs/Gemini_CLI_setup.md

Gemini CLI Setup

Installation

The Gemini CLI is an official tool from Google to interact with Gemini models from your terminal.

Option 1: Local Installation (Recommended for this project)

This project includes Gemini CLI as a local npm dependency. Simply run:

npm install

Or use the setup script:

bash setup.sh
# Then select option 2: Install npm dependencies

The Gemini CLI will be available at ./node_modules/.bin/gemini.

To use it, either:

• Run directly: ./node_modules/.bin/gemini
• Or use via npm script: npx gemini

Option 2: Global Installation

Install it globally using npm:

sudo npm install -g @google/gemini-cli

This makes the gemini command available system-wide.

Version Information

This project uses Gemini CLI version 0.30.0-nightly.20260212.207ac6f2d, which includes important fixes for headless mode detection (commit 6a2f2d3a91380985c9ada6d39219fb353b4291b2).

Authentication

The Gemini CLI requires a Google AI API Key. You can get one from Google AI Studio.

Option 1: Environment Variable (Recommended)

Set the GEMINI_API_KEY environment variable in your shell profile or .env file:

export GEMINI_API_KEY="your_api_key_here"

Option 2: Settings File

You can also set the API key in the Gemini CLI settings file at ~/.gemini/settings.json:

{
  "auth": {
    "apiKey": "your_api_key_here"
  }
}

Usage

Interactive Mode

Simply run the command to start a chat:

# If installed locally
npx gemini

# If installed globally
gemini

Non-Interactive Mode

Send a single prompt and exit:

# If installed locally
npx gemini --prompt "What is the capital of France?"

# If installed globally
gemini --prompt "What is the capital of France?"

Using a Specific Model

# If installed locally
npx gemini --model gemini-2.0-flash --prompt "Analyze this code..."

# If installed globally
gemini --model gemini-2.0-flash --prompt "Analyze this code..."

Quick Verification

Check the version to ensure it is installed correctly:

# If installed locally
npx gemini --version

# If installed globally
gemini --version

Expected output: 0.30.0-nightly.20260212.207ac6f2d