https://github.com/reugn/gemini-cli

A command-line interface (CLI) for Google Gemini
https://github.com/reugn/gemini-cli

aichat chatai cli cli-app command-line commandline gemini gemini-client google-ai google-gemini terminal

Last synced: 9 days ago
JSON representation

A command-line interface (CLI) for Google Gemini

• Host: GitHub
• URL: https://github.com/reugn/gemini-cli
• Owner: reugn
• License: mit
• Created: 2024-02-17T13:07:59.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-09-11T19:28:01.000Z (about 2 months ago)
• Last Synced: 2024-09-12T05:36:01.852Z (about 2 months ago)
• Topics: aichat, chatai, cli, cli-app, command-line, commandline, gemini, gemini-client, google-ai, google-gemini, terminal
• Language: Go
• Homepage: https://pkg.go.dev/github.com/reugn/gemini-cli
• Size: 43 KB
• Stars: 58
• Watchers: 2
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-cli-apps - gemini-cli - A command-line interface (CLI) for Google Gemini. (<a name="ai"></a>AI / ChatGPT)
• awesome-cli-apps-in-a-csv - gemini-cli - A command-line interface (CLI) for Google Gemini. (<a name="ai"></a>AI / ChatGPT)

README

        
# gemini-cli

[![Build](https://github.com/reugn/gemini-cli/actions/workflows/build.yml/badge.svg)](https://github.com/reugn/gemini-cli/actions/workflows/build.yml)

[![PkgGoDev](https://pkg.go.dev/badge/github.com/reugn/gemini-cli)](https://pkg.go.dev/github.com/reugn/gemini-cli)

[![Go Report Card](https://goreportcard.com/badge/github.com/reugn/gemini-cli)](https://goreportcard.com/report/github.com/reugn/gemini-cli)

A command-line interface (CLI) for [Google Gemini](https://deepmind.google/technologies/gemini/).

Google Gemini is a family of multimodal artificial intelligence (AI) large language models that have

capabilities in language, audio, code and video understanding.

The current version only supports multi-turn conversations (chat), using the `gemini-pro` model.

## Installation

Choose a binary from the [releases](https://github.com/reugn/gemini-cli/releases).

### Build from Source

Download and [install Go](https://golang.org/doc/install).

Install the application:

```sh

go install github.com/reugn/gemini-cli/cmd/gemini@latest

```

See the [go install](https://go.dev/ref/mod#go-install) instructions for more information about the command.

## Usage

### API key

To use `gemini-cli`, you'll need an API key set in the `GEMINI_API_KEY` environment variable.

If you don't already have one, create a key in [Google AI Studio](https://makersuite.google.com/app/apikey).

> [!NOTE]

> For information on the available regions for the Gemini API and Google AI Studio, see [here](https://ai.google.dev/available_regions#available_regions).

### System commands

The system chat message must begin with an exclamation mark and is used for internal operations.

A short list of supported system commands:

| Command | Description

| ---     | ---

| !q      | Quit the application

| !p      | Delete the history used as chat context by the model

| !m      | Toggle input mode (single-line <-> multi-line)

### CLI help

```console

$ ./gemini -h

Gemini CLI Tool

Usage:

   [flags]

Flags:

  -f, --format         render markdown-formatted response (default true)

  -h, --help           help for this command

  -m, --multiline      read input as a multi-line string

  -s, --style string   markdown format style (ascii, dark, light, pink, notty, dracula) (default "auto")

  -t, --term string    multi-line input terminator (default "$")

  -v, --version        version for this command

```

## License

MIT