Gemini CLI Installation and Usage Guide

This document will guide you through installing and configuring the Gemini CLI to work with the https://api.cometapi.com service endpoint.

💡 Prerequisites
Before you begin, please ensure your environment meets the following requirements:
Operating System: Windows 10/11, macOS 10.15+, Ubuntu 20.04+, or Debian 10+
Node.js: Version 20.0 or higher

1️⃣ Install Node.js (Skip if Node.js version ≥ 20.0 is already installed)

For Windows Users

For Ubuntu / Debian Users

For macOS Users

2️⃣ Install Gemini CLI

If the installation is successful, running gemini will display a welcome message or open the interactive command-line interface.

3️⃣ Start Using

Step 1: Get Configuration Info

To use Gemini CLI with https://api.cometapi.com, you will need two key pieces of information:

API Key (GEMINI_API_KEY)

This is your personal access key obtained after registering on the api.cometapi.com platform (it usually starts with sk-).

API Endpoint (GOOGLE_GEMINI_BASE_URL)

This is our API service endpoint address, which is fixed at https://api.cometapi.com.

Step 2: Run Gemini CLI (Temporary Session)

The following commands are only effective for the current terminal session. You will need to set them again after closing the terminal.

On the first run, you will be prompted to complete the initial setup:

Choose your preferred theme + Enter

Confirm the safety notice + Enter

Trust the working directory + Enter

Now, you can start collaborating with your AI assistant right in the terminal! 🚀

4️⃣ Configure Environment Variables (Recommended)

To avoid re-typing the export command every time you open a new terminal, it is highly recommended to add the environment variables to your shell's configuration file permanently.

Step 1: Write to Configuration File

Run the following commands. They will automatically append the configuration to ~/.bash_profile, ~/.bashrc (for Bash), and ~/.zshrc (for Zsh).

Step 2: Use After Restarting Terminal

You must completely close and reopen your terminal for the changes to take effect. Afterwards, you can simply navigate to your project directory and run gemini.

❓ FAQ (Frequently Asked Questions)

Important Note: Our service acts only as a proxy for the Gemini CLI and cannot process API requests for other services.

Q: What should I do if I encounter an API error?
A: This might be due to temporary instability in the proxy network. You can try quitting the Gemini CLI (type /quit or press Ctrl+C) and retrying a few times.

Q: How do I fix an Invalid API Key related error?
A: This error indicates that the Gemini CLI did not detect the GEMINI_API_KEY and GEMINI_API_ENDPOINT environment variables. Please go back to Step 4, double-check that the variables are configured correctly, and ensure you have restarted your terminal.

Q: Why do my requests always show fetch failed?
A: This could be due to network environment issues in your region, preventing a stable connection to our proxy server. Try using a system-wide proxy tool.

Q: How do I uninstall the Gemini CLI?
A: You can run the following command to uninstall it:

Gemini CLI Installation and Usage Guide

💡 Prerequisites#

1️⃣ Install Node.js (Skip if Node.js version ≥ 20.0 is already installed)#

For Windows Users#

For Ubuntu / Debian Users#

For macOS Users#

2️⃣ Install Gemini CLI#

3️⃣ Start Using#

Step 1: Get Configuration Info#

Step 2: Run Gemini CLI (Temporary Session)#

4️⃣ Configure Environment Variables (Recommended)#

Step 1: Write to Configuration File#

Step 2: Use After Restarting Terminal#

❓ FAQ (Frequently Asked Questions)#

💡 Prerequisites