{"id":15680654,"url":"https://github.com/pradumnasaraf/gencli","last_synced_at":"2025-06-20T18:15:12.742Z","repository":{"id":245593972,"uuid":"818697460","full_name":"Pradumnasaraf/gencli","owner":"Pradumnasaraf","description":"GenCLI is an AI-powered CLI tool built with Golang that answers your questions using the Google Gemini API. It is developed with Cobra and Viper libraries.","archived":false,"fork":false,"pushed_at":"2025-05-20T14:47:49.000Z","size":109,"stargazers_count":25,"open_issues_count":2,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-14T02:42:32.995Z","etag":null,"topics":["ai","cli","cobra","gemini","genai","golang","viper"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/Pradumnasaraf/gencli","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pradumnasaraf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["eddiejaoude"]}},"created_at":"2024-06-22T15:39:14.000Z","updated_at":"2025-05-20T14:47:38.000Z","dependencies_parsed_at":"2024-07-09T21:53:13.881Z","dependency_job_id":"b8243b0c-9fda-4ec2-adf9-5c8da573f221","html_url":"https://github.com/Pradumnasaraf/gencli","commit_stats":null,"previous_names":["pradumnasaraf/gencli"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/Pradumnasaraf/gencli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pradumnasaraf%2Fgencli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pradumnasaraf%2Fgencli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pradumnasaraf%2Fgencli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pradumnasaraf%2Fgencli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pradumnasaraf","download_url":"https://codeload.github.com/Pradumnasaraf/gencli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pradumnasaraf%2Fgencli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260994124,"owners_count":23094289,"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":["ai","cli","cobra","gemini","genai","golang","viper"],"created_at":"2024-10-03T16:43:48.605Z","updated_at":"2025-06-20T18:15:07.730Z","avatar_url":"https://github.com/Pradumnasaraf.png","language":"Go","funding_links":["https://github.com/sponsors/eddiejaoude"],"categories":[],"sub_categories":[],"readme":"## GenCLI\n\n\u003cdiv align=\"center\"\u003e\n\n[![Releases](https://github.com/Pradumnasaraf/gencli/actions/workflows/releases.yml/badge.svg)](https://github.com/Pradumnasaraf/gencli/actions/workflows/releases.yml) [![Go Reference](https://pkg.go.dev/badge/github.com/Pradumnasaraf/gencli.svg)](https://pkg.go.dev/github.com/Pradumnasaraf/gencli)\n\n\u003c/div\u003e\n\n**GenCLI** is an AI-powered CLI tool built with Golang that answers your questions using the [Google Gemini API](https://gemini.google.com). It is developed with [Cobra](https://github.com/spf13/cobra) and [Viper](https://github.com/spf13/viper) libraries.\n\n![GenCLI GIF](https://github.com/Pradumnasaraf/gencli/assets/51878265/f230a612-c51b-45b1-bbab-772110efcaf4)\n\n### 📦 Features\n\n- **Dynamic Model selection**: Choose from a variety of GenAI models to get the best results.\n- **Image Analysis**: Get details about an image.\n- **Search**: Ask a question and get a response.\n- **Update**: easily update GenCLI to the latest version with a single command.\n- **Output Language**: Get the response in your preferred language.\n- **Temperature**: Control the creativity of the response.\n\n### 🚀 Getting Started\n\nTo get started with GenCLI, you can install it using the following method:\n\n#### Installation\n\nTo install the CLI, use the command below:\n\n```bash\ngo install github.com/Pradumnasaraf/gencli@latest\n```\n\nGo will automatically install it in your `$GOPATH/bin` directory, which should be in your `$PATH`.\n\n#### Usage\n\nOnce installed, you can use the `gencli` CLI command. To confirm installation, type `gencli` at the command line. All the CLI config (like current GenAI Model, etc) is store in `~/.gencli` directory.\n\nGenCLI uses the Google Gemini API, so you need to set the API key. To get the API key (It's FREE), visit [here](https://aistudio.google.com/app/apikey?_gl=1*1n5ijhw*_ga*MTQxNDQ2MjcyNi4xNzE5MDU4OTE0*_ga_P1DBVKWT6V*MTcxOTkzNTQzOC4zLjEuMTcxOTkzNTQ3My4yNS4wLjEzODczMjU2OA) and set it in the environment variable `GEMINI_API_KEY`:\n\n```bash\nexport GEMINI_API_KEY=\u003cAPI_KEY\u003e\n```\n\nThe above method sets the API key for the current session only. To set it permanently, add the above line to your `.bashrc` or `.zshrc` file.\n\n\u003e [!NOTE]  \n\u003e If you encounter the error `command not found: gencli`, you need to add `$GOPATH/bin` to your `$PATH` environment variable. For more details, refer to [this guide](https://gist.github.com/Pradumnasaraf/ca6f9a0507089a4c44881446cdda4aa3).\n\n#### Commands\n\nBelow is the list of commands available in GenCLI:\n\n```bash\nUsage:\n  gencli [flags]\n  gencli [command]\n\nAvailable Commands:\n  help        Help about any command\n  image       Know details about an image (Please put your question in quotes)\n  model       To select a different GenAI model\n  search      Ask a question and get a response (Please put your question in quotes)\n  update      Update gencli to the latest version\n  version     Know the installed version of gencli\n\nFlags:\n  -h, --help   help for gencli\n```\n\nAn overview of subcommands with all the available options:\n\n```bash\nUsage:\n  gencli image [your question] --path [image path] --format [image format] [flags]\n\nExamples:\ngencli image 'What this image is about?' --path cat.png --format png\n\nFlags:\n  -f, --format string         Enter the image format (jpeg, png, etc.) (default \"jpeg\")\n  -h, --help                  help for image\n  -l, --language string       Enter the language for the output (default \"english\")\n  -o, --output string         Output file name (default \"output.txt\")\n  -p, --path string           Enter the image path\n  -s, --save                  Save the output to a file\n  -t, --temperature float32   Response creativity (0.0-1.0) (default 0.5)\n```\n\nThis is for the `image` subcommand. Same goes for the `search` and other subcommands.\n\n### 📜 License\n\nThis project is licensed under the Apache-2.0 license - see the [LICENSE](LICENSE) file for details.\n\n### 🛡 Security\n\nIf you discover a security vulnerability within this project, please check the [SECURITY](SECURITY.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpradumnasaraf%2Fgencli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpradumnasaraf%2Fgencli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpradumnasaraf%2Fgencli/lists"}