Package: aidotpy
ai.pyA single-file Python script that interacts with ChatGPT API in the command-line.Features:Use shortcuts to access predefined promptsHighlight code in outputSupport one-shot queries and conversationsUse special command like!setto control the behavior when chattingInstallJust copy the script to a folder in$PATH, like/usr/local/bin. You can also change its name toaito get ride of the.pyextension.Here's a command that can directly install the script into your system:curl https://raw.githubusercontent.com/reorx/ai.py/master/ai.py -o /usr/local/bin/ai && chmod +x /usr/local/bin/aiYou can also install it with pip or pipx:pip install aidotpyUsagePaste your OpenAI API key to~/.ai_py_config.json, or set it inAI_PY_API_KEYenvironment variable.echo'{"api_key":"<Your API key>"}'>~/.ai_py_config.jsonFor detail usage of the script, please read the description of./ai.py -h:usage: ai [-h] [-s SYSTEM] [-c] [--history HISTORY] [-w] [-v] [-t] [-d]
          [--version]
          [PROMPT]

A simple CLI for ChatGPT API

positional arguments:
  PROMPT                your prompt, leave it empty to run REPL. you can use @
                        to load prompt from ~/.ai_py_prompts.json

options:
  -h, --help            show this help message and exit
  -s SYSTEM, --system SYSTEM
                        system message to use at the beginning of the
                        conversation. if starts with @, the message will be
                        located through ~/.ai_py_prompts.json
  -c, --conversation    enable conversation, which means all the messages will
                        be sent to the API, not just the last one. This is
                        only useful to REPL
  --history HISTORY     load the history from a JSON file.
  -w, --write-history   write new messages to --history file after each chat.
  -v, --verbose         verbose mode, show execution info and role in the
                        message
  -t, --show-tokens     show a breakdown of the tokens used in the prompt and
                        in the response
  -d, --debug           debug mode, enable logging
  --version             show program's version number and exitOne-off queryPass the prompt as the first argument:./ai.py 'hello world'You can also pass the prompt through a pipe (|):head README.md | ./ai.py 'Proofreading the following text:'REPLRun without argument forRead–eval–print loop:./ai.pyBy default only the last message and the system message are sent to the API,
if you want it to remember all the context (i.e. send all the messages in each chat),
add-cargument to enable conversation:./ai.py -cSystem messageYou can pass a system message to define the behavior for the assistant:./ai.py -s 'You are a proofreader' 'its nice know you'You can also save your predefined system messages in~/.ai_py_promots.jsonand refer them with@at the beginning, this will be covered in the next section.Prompt shortcutsYou can predefine prompts in~/.ai_py_prompts.jsonand refer to them by using@as a prefix.
This works for both system messages and user messages.Suppose your~/.ai_py_prompts.jsonlooks like this:{"system":{"cli":"As a technology assistant with expertise in command line, answer questions in simple and short words for users who have a high-level background. Provide only one example, and explain as less as possible."},"user":{"native":"Paraphrase the following sentences to make it more native:\n","revise":"Revise the following sentences to make them more clear concise and coherent:\n","":""}}Then you can use thecliprompt shortcut in system message by:./ai.py -s @cliand use thenativeorreviseprompt shortcut in user message by:./ai.py '@native its nice know you'

It's great to get to know you.Verbose modeAdd-vto print role name and parameters used in the API call.ScreenshotSpecial commandsYou can use special commands to control the behavior of the script when running in REPL.Here's a list of available commands:!set <key> <value>: set a key-value pair in the config, available keys are:verbose: set toTrueorFalse, e.g.!set verbose Trueconversation: set toTrueorFalse, e.g.!set conversation Truesystem: set the system message. e.g.!set system you are a poet,!set system @cliparams: set the parmeters for the ChatGPT API. e.g.!set params temperature 0.5model: set the model to use. e.g.!set model gpt-4!info: print the execution info!write-history: write current messages to history file. e.g.!write-history history.json