{"id":20398946,"url":"https://github.com/aiyu-ayaan/gemini-cli","last_synced_at":"2025-09-24T02:32:03.217Z","repository":{"id":243634451,"uuid":"812608975","full_name":"aiyu-ayaan/Gemini-CLI","owner":"aiyu-ayaan","description":"A command-line base Gemini client","archived":false,"fork":false,"pushed_at":"2024-06-13T18:02:18.000Z","size":34587,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-15T04:27:14.730Z","etag":null,"topics":["chat-bot","chatbot","command-line","gemini-ai","gemini-api","python","summarizer"],"latest_commit_sha":null,"homepage":"https://aiyu-ayaan.github.io/Gemini-CLI/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aiyu-ayaan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-09T11:32:34.000Z","updated_at":"2024-09-20T16:24:54.000Z","dependencies_parsed_at":"2024-11-15T04:36:24.416Z","dependency_job_id":null,"html_url":"https://github.com/aiyu-ayaan/Gemini-CLI","commit_stats":null,"previous_names":["aiyu-ayaan/gemini-cli"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiyu-ayaan%2FGemini-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiyu-ayaan%2FGemini-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiyu-ayaan%2FGemini-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aiyu-ayaan%2FGemini-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aiyu-ayaan","download_url":"https://codeload.github.com/aiyu-ayaan/Gemini-CLI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234026121,"owners_count":18768073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat-bot","chatbot","command-line","gemini-ai","gemini-api","python","summarizer"],"created_at":"2024-11-15T04:25:21.102Z","updated_at":"2025-09-24T02:31:56.580Z","avatar_url":"https://github.com/aiyu-ayaan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Gemini CLI: Interact with Google's AI on the Command Line\n\n\n\nhttps://github.com/aiyu-ayaan/Gemini-CLI/assets/76834976/dbaf9e35-28fc-4514-92c3-3235cfcc36c2\n\n\nThis is a command-line interface (CLI) for interacting with Google's Gemini large language models (LLMs) using your\nGemini API key. It allows you to:\n\n* **Generate text:** Prompt Gemini for creative text formats, like poems, code, scripts, musical pieces, email,\n  letters, etc.\n* **Summarize YouTube videos:** Provide a YouTube URL and get a concise summary of the video content.\n* **Ask questions about YouTube videos:** After summarizing a video, use Gemini's knowledge to answer your questions\n  about the content.\n\n**Features:**\n\n* Simple and easy-to-use interface\n* Integrates with YouTube summaries for informed questioning\n* Leverages the power of Google's Gemini LLMs\n\n**Requirements:**\n\n* **Gemini API key:** Obtain a key from [https://ai.google.dev/gemini-api/docs/api-key) (Free tier available)\n\n**Installation:**\n\nThere are two ways to get started with Gemini CLI:\n\n1. **Download a pre-built executable (if available):**\n\n    * Check the project's Releases section on GitHub for downloadable executables (.exe for Windows, etc.). This is the\n      easiest option if available for your operating system.\n    * Download the appropriate installer for your system and follow the installation instructions.\n\n2. **Build from source (for advanced users or when pre-built executables are not available):**\n\n    * **Prerequisites:**\n        * Python 3.x ([https://www.python.org/downloads/](https://www.python.org/downloads/))\n    * **Steps:**\n        * Clone this repository:\n\n          ```bash\n          git clone https://github.com/aiyu-ayaan/Gemini-CLI\n          ```\n          (Replace `your-username` with your GitHub username)\n\n        * Install dependencies:\n\n          ```bash\n          cd Gemini-CLI\n          pip install -r requirements.txt\n          ```\n\n**Usage:**\nThe Gemini CLI provides several command-line arguments to interact with the tool. Below are the supported arguments and\ntheir descriptions.\n\n**Arguments:**\n\n- `--question`, `-q`:\n    - Type: `str`\n    - Description: The question to ask Gemini.\n    - Example: `--question \"What is the capital of France?\"`\n\n- `--word-limit`, `-wl`:\n    - Type: `int`\n    - Default: `0`\n    - Description: Sets the word limit for the response from Gemini.\n    - Example: `--word-limit 50`\n\n- `--info`, `-i`:\n    - Action: `InfoAction`\n    - Description: Displays information about the Gemini CLI.\n    - Example: `--info`\n\n- `--youtube`, `-yt`:\n    - Type: `str`\n    - Description: YouTube URL to get the transcript from.\n    - Example: `--youtube \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"`\n- `--pdf` , `-p`:\n    - Type: `str`\n    - Description: PDF file to get the text from.\n    - Example: `--pdf \"path/to/pdf/file.pdf\"`\n- `--start-page-index` , `-spi`:\n    - Type: `int`\n    - Description: The index of the page to start extracting text from.\n    - Example: `--start-page-index 2\n- `--end-page-index` , `-epi`:\n    - Type: `int`\n    - Description: The index of the page to end extracting text from.\n    - Example: `--end-page-index 5`\n- `--export-docx` , `-ed`:\n    - Type: `str`\n    - Description: Export the response to docx file.\n    - Example: `--export-docx \"file.docx\"`\n- `--output-path` , `-op`:\n    - Type: `str`\n    - Description: The path to save the response.\n    - Example: `--output-path \"path/to/save/\"`\n\n### Summarizing YouTube Videos\n\nTo summarize a YouTube video, you can use the `-yt`, `-wl`, and `-q` tags together. Below is an example of how to use\nthese tags:\n\nIn this example:\n\n- The `-yt` tag specifies the YouTube URL.\n- The `-wl` tag sets a word limit of 100 words for the response.\n- The `-q` tag provides the question to ask Gemini which in this case is to summarize the main points of the video.\n\n**Examples**\n\n**Asking a Question**\n\n```bash\npython gemini-cli -q \"What is the weather like today?\"\n```\n\n**Setting a Word Limit for the Response**\n\n```bash\npython gemini-cli -q \"Explain the theory of relativity.\" -wl 50\n```\n\n**Getting Information About the CLI**\n\n```bash\npython gemini-cli -i\n```\n\n**Summarizing a YouTube Video**\n\n```bash\npython gemini-cli -yt \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"\n```\n\n**Asking a Question About a YouTube Video**\n\n```bash\npython gemini-cli -yt \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\" -wl 100 -q \"What are the main points discussed in this video?\"\n```\n\n***Ask a Question from the provided PDF file***\n\n```bash\ngemini -p \"path/to/file.pdf\" -q \"What is the main idea of this document?\"\n```\n\n***Export the response to a docx file***\n\n```bash\ngemini -q \"What is the capital of France?\" -ed \"output.docx\"\n```\n\n**License:**\n\n```plaintext\nThis is free and unencumbered software released into the public domain.\n\nAnyone is free to copy, modify, publish, use, compile, sell, or\ndistribute this software, either in source code form or as a compiled\nbinary, for any purpose, commercial or non-commercial, and by any\nmeans.\n\nIn jurisdictions that recognize copyright laws, the author or authors\nof this software dedicate any and all copyright interest in the\nsoftware to the public domain. We make this dedication for the benefit\nof the public at large and to the detriment of our heirs and\nsuccessors. We intend this dedication to be an overt act of\nrelinquishment in perpetuity of all present and future rights to this\nsoftware under copyright law.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR\nOTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,\nARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\nOTHER DEALINGS IN THE SOFTWARE.\n\nFor more information, please refer to \u003chttps://unlicense.org\u003e\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faiyu-ayaan%2Fgemini-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faiyu-ayaan%2Fgemini-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faiyu-ayaan%2Fgemini-cli/lists"}