Gemini CLI

Have an API key from the ViVi-API dashboard ready, and confirm that its group supports your chosen model. Back up any existing configuration before merging the fields below.

1. Install and verify

Install Node.js 20 or later and npm, then run:

node --version
npm install -g @google/gemini-cli
gemini --version

2. Set environment variables

Windows PowerShell
macOS / Linux

For the current terminal session:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.viviai.cc"
$env:GEMINI_API_KEY = "sk-your-api-key"

Optionally save them as user environment variables:

[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.viviai.cc', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-your-api-key', 'User')

Newly opened terminals will pick up the saved user environment variables.

For the current terminal session:

export GOOGLE_GEMINI_BASE_URL="https://api.viviai.cc"
export GEMINI_API_KEY="sk-your-api-key"

For Zsh, add these two export lines to ~/.zshrc, then run:

source ~/.zshrc

For Bash, add them to ~/.bashrc and run source ~/.bashrc.

3. Launch and test

gemini

Choose Gemini API Key authentication on first launch. To change authentication later, enter /auth in the interactive session. You can also test without entering interactive mode:

gemini -p "Hello, please confirm that the connection works."

If the default model is unavailable, run gemini -m gemini-3-flash-preview to select a model your account supports. The base URL environment variable takes the hostname; the client appends the Gemini API path. See the Integration overview and FAQ for more help.

Integration guides

AI assistants

Chat apps

Coding tools

1. Install and verify

2. Set environment variables

3. Launch and test

​1. Install and verify

​2. Set environment variables

​3. Launch and test

1. Install and verify

2. Set environment variables

3. Launch and test