From 51f1fd0611cd6af81a80138828cbd4b8ecfeb981 Mon Sep 17 00:00:00 2001 From: schark Date: Mon, 4 Dec 2023 22:08:51 -0800 Subject: Update readme --- README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 50 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 12f856b..a5e192f 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,51 @@ -# CLI GPT + + ██████╗██╗ ██╗ ██████╗ ██████╗ ████████╗ + ██╔════╝██║ ██║ ██╔════╝ ██╔══██╗╚══██╔══╝ + ██║ ██║ ██║█████╗██║ ███╗██████╔╝ ██║ + ██║ ██║ ██║╚════╝██║ ██║██╔═══╝ ██║ + ╚██████╗███████╗██║ ╚██████╔╝██║ ██║ + ╚═════╝╚══════╝╚═╝ ╚═════╝ ╚═╝ ╚═╝ + -A basic CLI program to replicate ChatGPT capabilities in the terminal for those with an OpenAI API key. An easy way to pay for the amount you use GPT-4 as opposed to the monthly flat rate for Plus members. +cli-gpt is a ChatGPT-like terminal wrapper to make interfacing with GPT models with an OpenAI API key easier. + +## Requirements and Installation + +I've tried to keep requirements low as to keep the program pretty minimal. Outside of native Python libraries, we're grabbing `openai` (obviously) to interface with the OpenAI API, `tiktoken` to get token information, and `prompt_toolkit` + `pygments` for better terminal handling. + +To install and run the program, simply execute the following commands. +``` +# Clone repository +git clone https://github.com/jordanscharkey/cli-gpt.git +cd cli-gpt/ + +# Create environment +python -m venv .venv/ +. .venv/bin/activate +pip install -r requirements.txt + +# Fill token file and run +vim token +python chat.py +``` + +### Token File + +To use this program, you will need an OpenAI API key. Keep this token in a file named `key` in the repository and the program should automatically read from it. + +## Additional Functionality + +The `/help` command will list all commands and a short description of what that command will accomplish. Here is a summary of those commands: + +``` + - /exit: Closes the chat. + - /context: Passthrough a URL to curl the context of into the chat history. + - /help: Display this list of available commands. + - /load: Load in a previous chat's JSON file. + - /save: Saves messages to specified JSON file and closes chat. + - /clear: Clears all messages and tokens from the chatlog, restarting the chat. + - /model: Change the model being used. + - /info: Print model information and cli-gpt version. + - /write: Write out any code from the previous message to a specified file. + - /copy: Copy code snippets from the previous message into the copy buffer. +``` -- cgit v1.2.3-18-g5258