{"id":39829169,"url":"https://github.com/weaponsforge/gemini-cli","last_synced_at":"2026-01-18T13:09:04.469Z","repository":{"id":302010156,"uuid":"1010894519","full_name":"weaponsforge/gemini-cli","owner":"weaponsforge","description":"Gemini CLI with directories and config setup","archived":false,"fork":false,"pushed_at":"2025-06-30T05:01:29.000Z","size":6,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2025-06-30T05:22:22.776Z","etag":null,"topics":["ai","gemini","gemini-cli"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/weaponsforge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-06-30T02:09:46.000Z","updated_at":"2025-06-30T04:03:53.000Z","dependencies_parsed_at":"2025-06-30T05:22:24.847Z","dependency_job_id":"dba3550a-1ca4-4883-a92c-3fa8d1b687c2","html_url":"https://github.com/weaponsforge/gemini-cli","commit_stats":null,"previous_names":["weaponsforge/gemini-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/weaponsforge/gemini-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaponsforge%2Fgemini-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaponsforge%2Fgemini-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaponsforge%2Fgemini-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaponsforge%2Fgemini-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weaponsforge","download_url":"https://codeload.github.com/weaponsforge/gemini-cli/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weaponsforge%2Fgemini-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28536694,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T13:04:05.990Z","status":"ssl_error","status_checked_at":"2026-01-18T13:01:44.092Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ai","gemini","gemini-cli"],"created_at":"2026-01-18T13:09:04.330Z","updated_at":"2026-01-18T13:09:04.453Z","avatar_url":"https://github.com/weaponsforge.png","language":"Dockerfile","readme":"## gemini-cli\n\nThis repository contains Docker files and recommended configurations for a quick and minimal setup of the [Google Gemini CLI](https://github.com/google-gemini/gemini-cli), installing it in an isolated container to avoid direct installation in a host machine.\n\n### 📋 Requirements\n\n1. Google Gemini API Key\n   - See the [Generating a Google Gemini Key](#-generating-a-google-gemini-key) reference for more information.\n\n2. Docker\n   - Windows OS (Docker Desktop): Docker version 27.4.0, build bde2b89\n   - Linux/Mac OS: _(applicable Docker versions)_\n\n\nDemo\n\nhttps://github.com/user-attachments/assets/c314e1be-7315-4a45-af37-41ed050d9be3\n\n## 🛠️ Installation\n\n1. Clone this repository.\n   - `git clone https://github.com/weaponsforge/gemini-cli.git`\n\n2. Create a `.env` file from the `.env.example` file. Replace the value of the `GEMINI_API_KEY` with your own Google Gemini API key.\n\n   | ID | Description |\n   | --- | --- |\n   | GEMINI_API_KEY | Google Gemini API key |\n   | GEMINI_MODEL | Gemini model\u003cbr\u003e\u003cul\u003e\u003cli\u003e`gemini-2.5-pro` (default)\u003c/li\u003e\u003cli\u003e`gemini-2.5-flash`, `gemini‑1.5‑pro`, etc\u003c/li\u003e\u003cli\u003e\u003cblockquote\u003e**INFO:** Exclude this from the `.env` file if there's no need to change the default model\u003c/blockquote\u003e\u003c/li\u003e\u003cul\u003e |\n\n   💡 Other Gemini CLI **environment variables** are available in its [Environment Variables \u0026 .env Files](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md#environment-variables--env-files) documentation.\n\n3. (Optional) Put code repositories or directories for Gemini CLI inspection under the `\"/projects\"` directory.\n   - See  the [projects/README.md](projects/README.md) file for more details on organizing your project repositories.\n   - **INFO:** this step is optional since the Gemini CLI does not require code repositories to answer general prompts.\n\n4. **Local build:** build the Docker image.\n   - Run this command only during the **initial installation** or if there are **changes to the `Dockerfile`**.\u003cbr\u003e\n   - `docker compose build`\n\n5. **Pull the pre-built Docker image**: (Optional) This repository deploys the \"latest\" Docker image to Docker Hub on the creation of new Release/Tags. It is available at: https://hub.docker.com/r/weaponsforge/gemini-cli\n   - Use this step to skip building the image locally at **step # 4**.\n   - Pull the pre-built development Docker image:\n      `docker pull weaponsforge/gemini-cli`\n\n## 📖 Usage\n\n1. Run the container.\n   - `docker compose up -d`\n\n2. Verify the container is running.\n   - `docker ps`\n\n3. Start the Gemini CLI from the container's command line.\n   - `docker exec -it weaponsforge-gemini-cli gemini`\n\n4. Use the Gemini CLI.\n   - Select a theme (eg., \"ANSI Light\")\n   - Type messages or prompts in the Gemini CLI's input message area.\n   - Use the `projects/` folder to reference codes or repositories within the Gemini CLI (mounted as Docker volumes) eg., `@projects/my-app`\n\n5. Exit the Gemini CLI.\n   - Press `Ctrl + C`\n\n6. Stop the container.\n   - `docker compose down`\n\n7. Verify the container stopped running. The following should yield empty logs.\n   ```\n   docker ps\n   docker ps -a\n   ```\n\n8. Cleanup: delete unused volumes.\n   - `docker volume prune`\n\n### 💡 Generating a Google Gemini Key\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to view notes\u003c/summary\u003e\n\n_(These steps require a Google account)_\n\n1. Create one from [Google AI Studio](https://aistudio.google.com/app/apikey).\n2. Follow the prompts for creating an API key.\n   - Type a project name in which to create the API key.\n   - \u003e **INFO:** You may also select an existing Google project in which to create the key.\n3. Copy the resulting API key in a safe and secure location.\n\n\u003c/details\u003e\n\n### 💡 Tips\n\n- The [Gemini CLI](https://github.com/google-gemini/gemini-cli) (using the free Gemini 2.5 Pro model) provides precise and accurate results but quickly exhausts the free subscription quotas when analyzing entire code bases. Use it alongside the (free-tier) [Cursor AI code editor](https://www.cursor.com/) to maximize free accounts/trial usage.\n\n## 📝 References\n\n- [Google Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- [Google Gemini Cookbook](https://github.com/google-gemini/cookbook)\n\n@weaponsforge\u003cbr\u003e\n20250630\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweaponsforge%2Fgemini-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweaponsforge%2Fgemini-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweaponsforge%2Fgemini-cli/lists"}