https://github.com/nDimensions-AI/Google-Gemini-CLI
Master the Gemini CLI: A Live, Interactive Webinar The most powerful AI models are now at your fingertips, right where you work: the terminal. Stop switching contexts and start accelerating your development workflow with the Google Gemini CLI.
https://github.com/nDimensions-AI/Google-Gemini-CLI
Last synced: 3 months ago
JSON representation
Master the Gemini CLI: A Live, Interactive Webinar The most powerful AI models are now at your fingertips, right where you work: the terminal. Stop switching contexts and start accelerating your development workflow with the Google Gemini CLI.
- Host: GitHub
- URL: https://github.com/nDimensions-AI/Google-Gemini-CLI
- Owner: nDimensions-AI
- Created: 2025-06-28T18:59:10.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-28T19:16:48.000Z (4 months ago)
- Last Synced: 2025-06-28T20:19:25.250Z (4 months ago)
- Language: Python
- Size: 1.18 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-gemini-cli - Google-Gemini-CLI - Master the Gemini CLI: A Live, Interactive Webinar. (Demo Collections & Examples)
- awesome-gemini-cli - **Google-Gemini-CLI** - Master the Gemini CLI: A Live, Interactive Webinar (Demo Collections & Examples)
README
# Gemini CLI Setup Guide
This guide provides a comprehensive walkthrough for setting up the Google Gemini Command-Line Interface (CLI), from checking prerequisites to installation and configuration.
## Table of Contents
1. [Prerequisites: Node.js and npm](#prerequisites-nodejs-and-npm)
* [Step 1: Check if Node.js and npm are Installed](#step-1-check-if-nodejs-and-npm-are-installed)
* [Step 2: Install Node.js and npm if Needed](#step-2-install-nodejs-and-npm-if-needed)
2. [Gemini CLI Installation & Configuration](#gemini-cli-installation--configuration)
* [Step 1: Install the Gemini CLI Package](#step-1-install-the-gemini-cli-package)
* [Step 2: Configure and Authenticate](#step-2-configure-and-authenticate)
3. [Uninstallation Guide](#uninstallation-guide)
## Prerequisites: Node.js and npm
The Gemini CLI is distributed via `npm` (Node Package Manager), which is bundled with Node.js. It is essential to have a recent version of both to ensure compatibility.
### Step 1: Check if Node.js and npm are Installed
Open your terminal or command prompt and run the following commands to check if you have Node.js and npm installed.
To check your **Node.js** version (version 18 or higher is required):
```bash
node -v
````
*Example output: `v18.18.0`*
To check your **npm** version:
```bash
npm -v
```
*Example output: `9.8.1`*
If both commands return a valid version number that meets the requirements, you can proceed to the next section.
### Step 2: Install Node.js and npm if Needed
If the commands above result in an error like "command not found" or the version is too old, you need to install or update Node.js.
1. **Go to the official Node.js website:** [https://nodejs.org/](https://nodejs.org/)
2. **Download the installer:** Choose the **LTS (Long Term Support)** version, which is recommended for most users.
3. **Run the installer:** Follow the on-screen instructions. The installer will automatically add both `node` and `npm` to your system's PATH.
After installation, close and reopen your terminal and run the `node -v` and `npm -v` commands again to verify that the installation was successful.
## Gemini CLI Installation & Configuration
With Node.js and npm ready, you can now install the Gemini CLI.
### Step 1: Install the Gemini CLI Package
Run the following command in your terminal to install the `@google/gemini-cli` package globally. The `-g` flag ensures the `gemini` command is accessible from any directory in your terminal.
```bash
npm install -g @google/gemini-cli
```
### Step 2: Configure and Authenticate
The first time you run the CLI, it will guide you through a one-time authentication process to connect with your Google account.
1. **Start the Gemini CLI:**
```bash
gemini
```
2. **Authenticate:** The CLI will provide a URL. Copy and paste this URL into your web browser.
3. **Grant Permissions:** Log in with your Google account and grant the necessary permissions when prompted.
4. **Confirmation:** After successful authentication, you will see a confirmation page. You can now return to your terminal.
Your Gemini CLI is now configured and ready for use\!
## Uninstallation Guide
If you need to remove the Gemini CLI from your system, you can do so with a single command.
```bash
npm uninstall -g @google/gemini-cli
```
This command will remove the globally installed package. For a complete cleanup, you may also want to remove the configuration directory:
* **macOS/Linux:** `rm -rf ~/.gemini`
* **Windows:** Delete the `.gemini` folder from your user directory (`C:\Users\YourUsername`).
# Use Cases
Here are the available use case files in this library:
* workflow-automation.md: Automate file system navigation, analysis, summarization, and cleanup.
* system-interaction-image-conversion.md: Identify, count, and perform batch conversions on image files.
* system-interaction-pdf-organization.md: Organize files like PDF invoices based on their content.
* mcp-slide-deck.md: (Advanced) Use an MCP server to generate a slide deck from your Git history.
* mcp-web-app.md: (Advanced) Use an MCP server to create a live web app dashboard from GitHub issues.