Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

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: 3 months 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 (4 months ago)
Default Branch: main
Last Pushed: 2024-03-09T12:48:40.000Z (3 months ago)
Last Synced: 2024-03-09T13:58:37.230Z (3 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: 39.1 KB
Stars: 30
Watchers: 1
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

cli-apps - gemini-cli - A command-line interface (CLI) for Google Gemini. (<a name="ai"></a>AI / ChatGPT)
awesome-cli-apps - 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