https://github.com/pradumnasaraf/gencli
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.
https://github.com/pradumnasaraf/gencli
ai cli cobra gemini genai golang viper
Last synced: about 1 year ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/pradumnasaraf/gencli
- Owner: Pradumnasaraf
- License: apache-2.0
- Created: 2024-06-22T15:39:14.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-05-20T14:47:49.000Z (about 1 year ago)
- Last Synced: 2025-06-14T02:42:32.995Z (about 1 year ago)
- Topics: ai, cli, cobra, gemini, genai, golang, viper
- Language: Go
- Homepage: https://pkg.go.dev/github.com/Pradumnasaraf/gencli
- Size: 106 KB
- Stars: 25
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
## GenCLI
[](https://github.com/Pradumnasaraf/gencli/actions/workflows/releases.yml) [](https://pkg.go.dev/github.com/Pradumnasaraf/gencli)
**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.
### 📦 Features
- **Dynamic Model selection**: Choose from a variety of GenAI models to get the best results.
- **Image Analysis**: Get details about an image.
- **Search**: Ask a question and get a response.
- **Update**: easily update GenCLI to the latest version with a single command.
- **Output Language**: Get the response in your preferred language.
- **Temperature**: Control the creativity of the response.
### 🚀 Getting Started
To get started with GenCLI, you can install it using the following method:
#### Installation
To install the CLI, use the command below:
```bash
go install github.com/Pradumnasaraf/gencli@latest
```
Go will automatically install it in your `$GOPATH/bin` directory, which should be in your `$PATH`.
#### Usage
Once 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.
GenCLI 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`:
```bash
export GEMINI_API_KEY=
```
The 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.
> [!NOTE]
> 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).
#### Commands
Below is the list of commands available in GenCLI:
```bash
Usage:
gencli [flags]
gencli [command]
Available Commands:
help Help about any command
image Know details about an image (Please put your question in quotes)
model To select a different GenAI model
search Ask a question and get a response (Please put your question in quotes)
update Update gencli to the latest version
version Know the installed version of gencli
Flags:
-h, --help help for gencli
```
An overview of subcommands with all the available options:
```bash
Usage:
gencli image [your question] --path [image path] --format [image format] [flags]
Examples:
gencli image 'What this image is about?' --path cat.png --format png
Flags:
-f, --format string Enter the image format (jpeg, png, etc.) (default "jpeg")
-h, --help help for image
-l, --language string Enter the language for the output (default "english")
-o, --output string Output file name (default "output.txt")
-p, --path string Enter the image path
-s, --save Save the output to a file
-t, --temperature float32 Response creativity (0.0-1.0) (default 0.5)
```
This is for the `image` subcommand. Same goes for the `search` and other subcommands.
### 📜 License
This project is licensed under the Apache-2.0 license - see the [LICENSE](LICENSE) file for details.
### 🛡 Security
If you discover a security vulnerability within this project, please check the [SECURITY](SECURITY.md) for more information.