Metadata-Version: 2.1
Name: chatgpt-cli-tool
Version: 1.2.3
Summary: Command line interface tool for interacting with ChatGPT using terminal
Home-page: https://github.com/lmatosevic/chatgpt-cli
Download-URL: https://github.com/lmatosevic/chatgpt-cli/archive/refs/tags/1.2.3.tar.gz
Author: luka
Author-email: lukamatosevic5@gmail.com
Keywords: chatgpt,openapi,cli,chat
Requires-Python: >=3.8.0
Description-Content-Type: text/markdown
License-File: LICENSE

# ChatGPT - Command Line Interface

> CLI tool for interacting with ChatGPT using terminal

## Requirements

* Python >= 3.8.0
* OpenAI account and valid API key

## Installation

Tool can be installed using python3 `pip` command:

```sh
pip install chatgpt-cli-tool
```

Or you can install it directly form this project after building it:

```sh
python build.py

pip install dist/chatgpt-cli-tool-{version}.tar.gz
```

## Configuration

In order to use ChatGPT cli you will first need to register and create an API key on
the [official OpenAI website](https://platform.openai.com/account/api-keys).

Then you can configure the tool with your API key using any of the following options:

1. Create an **~/.chatgpt-cli/.env** file with variable **OPENAI_API_KEY**
2. Create an **.env** file in the working directory with variable **OPENAI_API_KEY**
3. Set it through environment variable **OPENAI_API_KEY**
4. Pass it as the first argument when executing this tool (e.g. `chatgpt-cli my_api_key`)

To see other configurable options for ChatGPT check out **.env.example** file.

## Running the CLI

If you installed the tool using pip, then simply start the cli using any of the following commands:

```sh
# interactive chat command template
chatgpt-cli [api_key]

# example with api key
chatgpt-cli my_api_key

# example without api key
chatgpt-cli
```

```sh
# single gpt request command template
gpt-ai [api_key] [query]

# single command example with api key and query argument
gpt-ai my_api_key "What is ChatGPT?"

# single command example with query argument
gpt-ai "What is ChatGPT?"

# single command example with query from stdin
cat question.txt | gpt-ai

# single command example with both query as argument and piped input
cat long-story.txt | gpt-ai "sumarize this text in 5 bullet points"

# single command example with both query as argument and input directly from file
gpt-ai "explain this code" < main.py
```

API key argument is optional, but if provided it will override API key defined using environment variables.

## License

ChatGPT-cli is [MIT licensed](LICENSE).
