Overview
The Gemini CLI Easy Installer checks for Node.js at the beginning of execution (Step 1/3). If Node.js is not found, it attempts to install it automatically usingwinget. This page covers common issues that occur during this process.
Error: winget Command Not Found
Problem Description
You see this error message:Root Cause
Thewinget command-line tool is not available on your system. This tool is required to automatically install Node.js.
Source code reference: gemini-cli-easy-installer-20250706.bat:19-26
Solutions
Solution 1: Install App Installer from Microsoft Store
Solution 1: Install App Installer from Microsoft Store
The recommended solution is to install the App Installer package:
- Open Microsoft Store
- Search for “App Installer”
- Click “Get” or “Install”
- Wait for installation to complete
- Close and reopen Command Prompt
- Run the installer again
App Installer includes the
winget command-line tool needed for automatic Node.js installation.Solution 2: Update Windows
Solution 2: Update Windows
Recent versions of Windows 10/11 include App Installer by default:
- Open Settings → Update & Security → Windows Update
- Click “Check for updates”
- Install all available updates
- Restart your computer
- Run the installer again
- Windows 11: All versions include winget by default
- Windows 10: Version 1809 or later (with App Installer installed)
Solution 3: Manual Node.js Installation
Solution 3: Manual Node.js Installation
If you cannot install winget, you can install Node.js manually:
- Visit nodejs.org
- Download the LTS version (recommended)
- Run the installer with default options
- Important: Check “Automatically install necessary tools” during installation
- Restart your computer
- Run the Gemini CLI installer again
Issue: Restart Required After Node.js Installation
Problem Description
After Node.js installation completes, you see this message:Why This Happens
When Node.js is installed, it adds itself to the system PATH environment variable. However, the current Command Prompt session does not automatically reload the PATH. A restart is required for the changes to take effect. Source code reference:gemini-cli-easy-installer-20250706.bat:33-44
What to Do
Restart your computer (recommended)
Restart your computer to ensure all environment variables are properly loaded.
While you might be able to proceed by just opening a new Command Prompt, restarting ensures all system components recognize the new Node.js installation.
Alternative: Manual PATH Refresh
If you cannot restart immediately, you can try refreshing the PATH in a new Command Prompt:Verification Steps
After resolving Node.js installation issues, verify the installation:Check Node.js Version
Check npm Version
Check PATH Configuration
Node.js Update Issues
The installer also attempts to update Node.js to the latest LTS version if an older version is detected. Source code reference:gemini-cli-easy-installer-20250706.bat:53-68
If Update Fails
If Node.js update fails but you have a working Node.js installation, the installer will continue with the existing version. You can manually update Node.js later:Additional Resources
Still Having Issues?
If you’ve tried all solutions and still cannot install Node.js:- Check your Windows version: Run
winverin Command Prompt - Verify you have administrator rights
- Check for corporate policies that may block software installation
- Try installing Node.js using the manual installer from nodejs.org
- Consult your IT department if on a managed computer
Once Node.js is successfully installed and detected, proceed to the next troubleshooting guide if you encounter issues with Gemini CLI installation.