Awesome
AI - a commandline ChatGPT (3.5/4) client in BASH with conversation/completion and image generation support
Features:
-
Interactive chat sessions with OpenAI
gpt-3.5-turbo
andgpt-4
completion API endpoint models (aka ChatGPT/ChatGPT4) -- note: ChatGPT4 currently requires an API key from a paid OpenAI plan to work -
Multiline input
-
Image generation support:
-
image preview grid rendered directly in the terminal
-
generate up to 10 images at a time
-
automatic URL shortening
-
optionally save images and prompt to local disk
-
-
Markdown support for replies (requires glow)
-
One shot Q&A with optional follow-up conversation
-
Data piping support (sending file contents to ChatGPT)
-
Full conversation support:
-
locally store unlimited conversations (in JSON format)
-
quick resume last conversation
-
delete/resume any stored conversation
-
conversation messages replay on resume
-
store current and start new conversation (reset history) during interactive sessions
-
Automatic conversation topic identification and update
-
Full command line options (ai -h
):
- Note: the
-4
optional parameter switches to GPT-4 model.
Start a new interactive conversation:
ai [-4]
One shot Q&A (will ask you to continue interacting, otherwise quit after answer):
ai [-4] "how many planets are there in the solar system?"
Generate one or more images (default 1, max 10):
ai -i [num] "a cute cat"
Submit data as part of the question:
cat file.txt | ai [-4] can you summarize the contents of this file?
List saved conversations:
ai -l
Continue last conversation:
ai [-4] -c
Continue specific conversation:
ai [-4] -c <conversation_id>
Delete a specific conversation:
ai -d <conversation_id>
Delete selected conversations:
ai -d <conversation_id_start>-<conversation_id_end>
Delete all conversations:
rm "$HOME/conversations.json"
Usage examples:
(Interaction and conversation resuming)
(Image generation)
(Input piping to stdin)
Installation:
Prerequisites:
-
Install jq, curl, imagemagick, catimg
- for e.g. Ubuntu:
apt -y install jq curl imagemagick catimg
- for e.g. Ubuntu:
-
Install glow for Markdown rendering support in your terminal
Script download:
Install the script by either cloning this repository or directly downloading to your $PATH
, e.g.:
curl "https://raw.githubusercontent.com/nitefood/ai-bash-gpt/master/ai" > /usr/bin/ai && chmod 0755 /usr/bin/ai