gemini-cli
starsforks
How to install gemini-cli?
google-gemini/gemini-cli
$git clone https://github.com/google-gemini/gemini-cliGemini CLI is an open-source AI agent that brings the power of Gemini directly into your terminal. It provides lightweight access to Gemini, giving you the most direct path from your prompt to our model.
README.md
| 1 | # Gemini CLI |
| 2 | |
| 3 | [](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml) |
| 4 | [](https://github.com/google-gemini/gemini-cli/actions/workflows/chained_e2e.yml) |
| 5 | [](https://www.npmjs.com/package/@google/gemini-cli) |
| 6 | [](https://github.com/google-gemini/gemini-cli/blob/main/LICENSE) |
| 7 | [](https://codewiki.google/github.com/google-gemini/gemini-cli?utm_source=badge&utm_medium=github&utm_campaign=github.com/google-gemini/gemini-cli) |
| 8 | |
| 9 |  |
| 10 | |
| 11 | Gemini CLI is an open-source AI agent that brings the power of Gemini directly |
| 12 | into your terminal. It provides lightweight access to Gemini, giving you the |
| 13 | most direct path from your prompt to our model. |
| 14 | |
| 15 | Learn all about Gemini CLI in our [documentation](https://geminicli.com/docs/). |
| 16 | |
| 17 | ## 🚀 Why Gemini CLI? |
| 18 | |
| 19 | - **🎯 Free tier**: 60 requests/min and 1,000 requests/day with personal Google |
| 20 | account. |
| 21 | - **🧠 Powerful Gemini 3 models**: Access to improved reasoning and 1M token |
| 22 | context window. |
| 23 | - **🔧 Built-in tools**: Google Search grounding, file operations, shell |
| 24 | commands, web fetching. |
| 25 | - **🔌 Extensible**: MCP (Model Context Protocol) support for custom |
| 26 | integrations. |
| 27 | - **💻 Terminal-first**: Designed for developers who live in the command line. |
| 28 | - **🛡️ Open source**: Apache 2.0 licensed. |
| 29 | |
| 30 | ## 📦 Installation |
| 31 | |
| 32 | See |
| 33 | [Gemini CLI installation, execution, and releases](https://www.geminicli.com/docs/get-started/installation) |
| 34 | for recommended system specifications and a detailed installation guide. |
| 35 | |
| 36 | ### Quick Install |
| 37 | |
| 38 | #### Run instantly with npx |
| 39 | |
| 40 | ```bash |
| 41 | # Using npx (no installation required) |
| 42 | npx @google/gemini-cli |
| 43 | ``` |
| 44 | |
| 45 | #### Install globally with npm |
| 46 | |
| 47 | ```bash |
| 48 | npm install -g @google/gemini-cli |
| 49 | ``` |
| 50 | |
| 51 | #### Install globally with Homebrew (macOS/Linux) |
| 52 | |
| 53 | ```bash |
| 54 | brew install gemini-cli |
| 55 | ``` |
| 56 | |
| 57 | #### Install globally with MacPorts (macOS) |
| 58 | |
| 59 | ```bash |
| 60 | sudo port install gemini-cli |
| 61 | ``` |
| 62 | |
| 63 | #### Install with Anaconda (for restricted environments) |
| 64 | |
| 65 | ```bash |
| 66 | # Create and activate a new environment |
| 67 | conda create -y -n gemini_env -c conda-forge nodejs |
| 68 | conda activate gemini_env |
| 69 | |
| 70 | # Install Gemini CLI globally via npm (inside the environment) |
| 71 | npm install -g @google/gemini-cli |
| 72 | ``` |
| 73 | |
| 74 | ## Release Channels |
| 75 | |
| 76 | See [Releases](https://www.geminicli.com/docs/changelogs) for more details. |
| 77 | |
| 78 | ### Preview |
| 79 | |
| 80 | New preview releases will be published each week at UTC 23:59 on Tuesdays. These |
| 81 | releases will not have been fully vetted and may contain regressions or other |
| 82 | outstanding issues. Please help us test and install with `preview` tag. |
| 83 | |
| 84 | ```bash |
| 85 | npm install -g @google/gemini-cli@preview |
| 86 | ``` |
| 87 | |
| 88 | ### Stable |
| 89 | |
| 90 | - New stable releases will be published each week at UTC 20:00 on Tuesdays, this |
| 91 | will be the full promotion of last week's `preview` release + any bug fixes |
| 92 | and validations. Use `latest` tag. |
| 93 | |
| 94 | ```bash |
| 95 | npm install -g @google/gemini-cli@latest |
| 96 | ``` |
| 97 | |
| 98 | ### Nightly |
| 99 | |
| 100 | - New releases will be published each day at UTC 00:00. This will be all changes |
| 101 | from the main branch as represented at time of release. It should be assumed |
| 102 | there are pending validations and issues. Use `nightly` tag. |
| 103 | |
| 104 | ```bash |
| 105 | npm install -g @google/gemini-cli@nightly |
| 106 | ``` |
| 107 | |
| 108 | ## 📋 Key Features |
| 109 | |
| 110 | ### Code Understanding & Generation |
| 111 | |
| 112 | - Query and edit large codebases |
| 113 | - Generate new apps from PDFs, images, or sketches using multimodal capabilities |
| 114 | - Debug issues and troubleshoot with natural language |
| 115 | |
| 116 | ### Automation & Integration |
| 117 | |
| 118 | - Automate operational tasks like querying pull requests or handling complex |
| 119 | rebases |
| 120 | - Use MCP servers to connect new capabilities, including |
| 121 | [media generation with Imagen, Veo or Lyria](https://gi |
People who liked this also viewed
6 picksType
- fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!MCP ServersNov 2025
- lean-lsp-mcpLean Theorem Prover MCPMCP ServersJul 2026
- rulesyncA Utility CLI for AI Coding AgentsMCP ServersJul 2026
- FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.MCP ServersJul 2026
- repomix📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.MCP ServersJul 2026
- mcp-serverMCP server for AI-assisted development of CAP applicationsMCP ServersJul 2026
