Giters

mountaineerbr / shellChatGPT

Shell wrapper for OpenAI's ChatGPT, DALL-E, Whisper, and TTS. Features LocalAI, Ollama, Gemini, Mistral, Groq, and Anthropic integration.

Home Page:https://gitlab.com/fenixdragao/shellchatgpt

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

awesome-chatgpt-promptsawesome-chatgpt-prompts-zhbashchatbotdavinciterminalchat-completionstext-completionsgpt-4-visionttslocalaiollamagemini-apigemini-promistral-apigpt-4ogroqllama3claude-3

shellChatGPT

Shell wrapper for OpenAI's ChatGPT, DALL-E, Whisper, and TTS. Features LocalAI, Ollama, Gemini, Mistral, and Groq integration.

Showing off Chat Completions

Chat completions with streaming by defaults.

Expand Markdown Processing

Chat with Markdown rendering

Markdown rendering of chat response (optional).

Expand Text Completions

Plain Text Completions

In pure text completions, start by typing some text that is going to be completed, such as news, stories, or poems.

Expand Insert Mode

Insert Text Completions

Add the insert tag [insert] where it is going to be completed. Mistral code models work well with the insert / fill-in-the-middel (FIM) mode! If no suffix is provided, it works as plain text completions.

Index

Click to expand!

🚀 Features

✨ Getting Started

✔️ Required Packages

  • Bash
  • cURL, and JQ

Optional Packages

Packages required for specific features.

Click to expand!
  • Base64 - Image endpoint, vision models
  • ImageMagick/fbida - Image edits and variations
  • Python - Modules tiktoken, markdown, bs4
  • mpv/SoX/Vlc/FFmpeg/afplay - Play TTS output
  • SoX/Arecord/FFmpeg - Record input (Whisper)
  • xdg-open/open/xsel/xclip/pbcopy - Open images, set clipboard
  • W3M/Lynx/ELinks/Links - Dump URL text
  • bat/Pygmentize/Glow/mdcat/mdless - Markdown support
  • termux-api/play-audio/termux-microphone-record/termux-clipboard-set - Termux system
  • poppler/gs/abiword/ebook-convert - Dump PDF as text
  • dialog/kdialog/zenity/osascript/termux-dialog - File picker

💾 Installation

A. Download the stand-alone chatgpt.sh script and make it executable:

wget https://gitlab.com/fenixdragao/shellchatgpt/-/raw/main/chatgpt.sh

chmod +x ./chatgpt.sh

B. Or clone this repo:

git clone https://gitlab.com/fenixdragao/shellchatgpt.git

C. Optionally, download and set the configuration file ~/.chatgpt.conf:

#save configuration template:
chatgpt.sh -FF >> ~/.chatgpt.conf

#edit:
chatgpt.sh -F

# Or
vim ~/.chatgpt.conf

🔥 Usage Examples 🔥

Chat cmpls with prompt confirmation

💬 Native Chat Completions

With command line options -cc, some properties are set automatically to create a chat bot. Start a new session in chat mode, and set a different temperature (gpt-3.5 and gpt-4+ models):

chatgpt.sh -cc -t0.7

Create Marv, the sarcastic bot manually:

chatgpt.sh -60 -cc --frequency-penalty=0.5 --temp=0.5 --top_p=0.3 --restart-seq='\nYou: ' --start-seq='\nMarv:' --stop='You:' --stop='Marv:' -S'Marv is a factual chatbot that reluctantly answers questions with sarcastic responses:'

Load the unix instruction file ("unix.pr") for a new session. The command line syntaxes below are all aliases:

chatgpt.sh -cc ..unix

chatgpt.sh -cc..unix

chatgpt.sh -cc -..unix

chatgpt.sh -cc -S ..unix

To only chage the history file that the session will be recorded, set the first positional argument in command line with the operator forward slash "/" and the name of the history file (defaults to the /session command).

chatgpt.sh -cc /test

chatgpt.sh -cc /stest

chatgpt.sh -cc "/session test"

Load an older session from the current (defaults) history file.

chatgpt.sh -cc /sub

chatgpt.sh -cc /.

chatgpt.sh -cc /fork.

chatgpt.sh -cc "/fork current"

In chat mode, simple run !sub or the equivalent command !fork current.

To load an older session from a history file that is different from the defaults, there are some options.

Change to it with command !session [name].

To copy a previous session, run /sub or /grep [regex] to load that session and resume from it.

Print out last session, optionally set the history name:

chatgpt.sh -P

chatgpt.sh -P /test

Vision Models (GPT-4-Vision)

To send an image / url to vision models, start the script and then either set the image with the !img chat command with one or more filepaths / URLs separated by the operator pipe |.

chatgpt.sh -cc -m gpt-4-vision-preview '!img path/to/image.jpg'

Alternatively, set the image paths / URLs at the end of the prompt interactively:

chatgpt.sh -cc -m gpt-4-vision-preview

[...]
Q: In this first user prompt, what can you see? | https://i.imgur.com/wpXKyRo.jpeg

TIP: Run chat command !info to check model configuration!

DEBUG: Set option -VV to see the raw JSON request body.

File Picker and Shell Dump

The /pick command opens a file picker (usually a command-line file manager). The selected file's path will be appended to the current prompt in editing mode.

The /pick and /sh commands may be run when typed at the end of the current prompt, such as [PROMPT] /sh, which opens a new shell instance to execute commands interactively. The output of these commands is appended to the current prompt.

When the /pick command is run at the end of the prompt, the selected file path is appended instead.

Voice In and Out + Chat Completions

🗣️ Chat completion with audio in and out (Whisper plus TTS):

chatgpt.sh -ccwz

Chat in Portuguese with Whisper and set onyx as the TTS voice:

chatgpt.sh -ccwz -- pt -- onyx

Chat mode provides a conversational experience, prompting the user to confirm each step.

For a more automated execution, set option -v, and -vv for hands-free experience (detect silence, experimental), such as:

chatgpt.sh -cc -w -z -v

chatgpt.sh -cc -w -z -vv

Chat Mode of Text Completions

When text completions is set for chatting with option -c, some properties are configured automatically to instruct the bot.

chatgpt.sh -c "Hello there! What is your name?"

📜 Text Completions

This is the pure text completions endpoint. It is typically used to complete input text, such as for completing part of an essay.

One-shot text completion:

chatgpt.sh "Hello there! What is your name?"

NOTE: For multiturn, set option -d.

A strong Instruction prompt may be needed for the language model to do what is required.

Set an instruction prompt for better results:

chatgpt.sh -d -S 'The following is a newspaper article.' "It all starts when FBI agents arrived at the governor house and"

chatgpt.sh -d -S'You are an AI assistant.'  "The list below contain the 10 biggest cities in the w"

Insert Mode of Text Completions

Set option -q (or -qq for multiturn) to enable insert mode and add the string [insert] where the model should insert text:

chatgpt.sh -q 'It was raining when [insert] tomorrow.'

NOTE: This example works with no instruction prompt! An instruction prompt in this mode may interfere with insert completions.

NOTE: Insert mode works with model instruct models.

Mistral AI has a nice FIM (fill-in-the-middle) endpoint that works with code models and is really good!

Script Help Assistant

If you have got a question about the script itself and how to set it up, there is a built-in assistant (much like M$ Office Clipper).

While in chat mode, type the command /help [question], in which the question is related to script features and your current chat settings, and how you can change them or invoke the script with the right syntax!

Markdown

To enable markdown rendering of responses, set command line option --markdown, or run /md in chat mode. To render last response in markdown once, run //md.

The markdown option uses bat as it has line buffering on by defaults, however other software is supported. Set it such as --markdown=glow or /md mdless on chat mode.

Type in any of the following markdown software as argument to the option: bat, pygmentize, glow, mdcat, or mdless.

⚙️ Prompts

Unless the chat option -c or -cc are set, no instruction is given to the language model. On chat mode, if no instruction is set, minimal instruction is given, and some options set, such as increasing temp and presence penalty, in order to un-lobotomise the bot.

Prompt engineering is an art on itself. Study carefully how to craft the best prompts to get the most out of text, code and chat completions models.

The model steering and capabilities require prompt engineering to even know that it should answer the questions.

⌨️ Custom Prompts

Set a one-shot instruction prompt with option -S:

chatgpt.sh -cc -S 'You are a PhD psycologist student.' 

chatgpt.sh -ccS'You are a professional software programmer.'

To create or load a prompt template file, set the first positional argument as .prompt_name or ..prompt_name. In the second case, load the prompt as instruction without a single-shot editing.

chatgpt.sh -cc .psycologist 

chatgpt.sh -cc ..software_programmer

Alternatively, set option -S with the operator and the name of the prompt as an argument:

chatgpt.sh -cc -S .psycologist 

chatgpt.sh -cc -S..software_programmer

This will load the custom prompt or create it if it does not yet exist. In the second example, single-shot editing will be skipped after loading prompt software_programmer.

Please note and make sure to backup your important custom prompts! They are located at "~/.cache/chatgptsh/" with the extension ".pr".

🔌 Awesome Prompts

Set a prompt from awesome-chatgpt-prompts or awesome-chatgpt-prompts-zh, (use with davinci and gpt-3.5+ models):

chatgpt.sh -cc -S /linux_terminal

chatgpt.sh -cc -S /Relationship_Coach 

chatgpt.sh -cc -S '%担任雅思写作考官'

Shell Completion

This project includes shell completions to enhance the user command-line experience.

Bash

Install following one of the methods below.

System-wide

sudo cp comp/bash/chatgpt.sh /usr/share/bash-completion/completions/

User-specific

mkdir -p ~/.local/share/bash-completion/completions/
cp comp/bash/chatgpt.sh ~/.local/share/bash-completion/completions/

Visit the bash-completion repository.

Zsh

Install at the system location

sudo cp comp/zsh/_chatgpt.sh /usr/share/zsh/site-functions/

User-specific location

To set user-specific completion, make sure to place the completion script under a directory in the $fpath array.

The user may create the ~/.zfunc/ directory, for example, and add the following lines to her ~/.zshrc:

[[ -d ~/.zfunc ]] && fpath=(~/.zfunc $fpath)

autoload -Uz compinit
compinit

Make sure compinit is run after setting $fpath!

Visit the zsh-completion repository.

Troubleshoot

Bash and Zsh completions should be active in new terminal sessions. If not, ensure your ~/.bashrc and ~/.zshrc source the completion files correctly.

💡 Notes and Tips

  • Run chat commands with either operator ! or /.

  • Edit live history entries with command !hist, for context injection.

  • Add operator forward slash / to the end of prompt to trigger preview mode.

  • One can regenerate a response typing in a new prompt a single slash /, or // to have last prompt edited before new request.

More Script Modes

🖼️ Image Generations

Generate image according to prompt:

chatgpt.sh -i "Dark tower in the middle of a field of red roses."

chatgpt.sh -i "512x512" "A tower."

Image Variations

Generate image variation:

chatgpt.sh -i path/to/image.png

Image Edits

chatgpt.sh -i path/to/image.png path/to/mask.png "A pink flamingo."

Outpaint - Canvas Extension

Displaying Image Edits - Extending the Canvas

In this example, a mask is made from the white colour.

Inpaint - Fill in the Gaps

Showing off Image Edits - Inpaint

Adding a bat in the night sky.

🔊 Audio Transcriptions / Translations

Generate transcription from audio file. A prompt to guide the model's style is optional. The prompt should match the audio language:

chatgpt.sh -w path/to/audio.mp3

chatgpt.sh -w path/to/audio.mp3 "en" "This is a poem about X."

1. Generate transcription from voice recording, set Portuguese as the language to transcribe to:

chatgpt.sh -w pt

This also works to transcribe from one language to another.

2. Transcribe any language audio input to Japanese (prompt should be in the same language as the input audio language, preferably):

chatgpt.sh -w ja "A job interview is currently being done."

3.1 Translate English audio input to Japanese, and generate audio output from text.

chatgpt.sh -wz ja "Getting directions to famous places in the city."

3.2 Also doing it conversely, this gives an opportunity to (manual) conversation turns of two speakers of different languages. Below, a Japanese speaker can translate its voice and generate audio in the target language.

chatgpt.sh -wz en "Providing directions to famous places in the city."

4. Translate audio file or voice recording from any language to English:

chatgpt.sh -W [audio_file]

chatgpt.sh -W

To retry with the last microphone recording saved in the cache, set audio_file as last or retry.

NOTE: Generate phrasal-level timestamps double setting option -ww or option -WW. For word-level timestamps, set option -www or -WWW.

Transcribe audio with timestamps

Service Providers

LocalAI

LocalAI Server

Make sure you have got mudler's LocalAI, server set up and running.

The server can be run as a docker container or a binary can be downloaded. Check LocalAI tutorials Container Images, and Run Models Manually for an idea on how to install, download a model and set it up.

 ┌───────────────────────────────────────────────────┐
 │                   Fiber v2.50.0                   │
 │               http://127.0.0.1:8080               │
 │       (bound on host 0.0.0.0 and port 8080)       │
 │                                                   │
 │ Handlers ............. 1  Processes ........... 1 │
 │ Prefork ....... Disabled  PID ..................1 │
 └───────────────────────────────────────────────────┘

Tips

1. Download a binary of localai for your system from Mudler's release GitHub repo.

2. Run localai run --help to check comamnd line options and environment variables.

3. Set up $GALLERIES before starting up the server:

export GALLERIES='[{"name":"localai", "url":"github:mudler/localai/gallery/index.yaml"}]'  #defaults

export GALLERIES='[{"name":"model-gallery", "url":"github:go-skynet/model-gallery/index.yaml"}]'

export GALLERIES='[{"name":"huggingface", "url": "github:go-skynet/model-gallery/huggingface.yaml"}]'

4. Install the model named phi-2-chat from a yaml file manually, while the server is running:

curl -L http://localhost:8080/models/apply -H "Content-Type: application/json" -d '{ "config_url": "https://raw.githubusercontent.com/mudler/LocalAI/master/embedded/models/phi-2-chat.yaml" }'

Running the shell wrapper

Finally, when running chatgpt.sh, set the model name:

chatgpt.sh --localai -cc -m luna-ai-llama2

Setting some stop sequences may be needed to prevent the model from generating text past context:

chatgpt.sh --localai -cc -m luna-ai-llama2  -s'### User:'  -s'### Response:'

Optionally set restart and start sequences for text completions endpoint (option -c), such as -s'\n### User: ' -s'\n### Response:' (do mind setting newlines \n and whitespaces correctly).

And that's it!

Installing Models

Model names may be printed with chatgpt.sh -l. A model may be supplied as argument, so that only that model details are shown.

NOTE: Model management (downloading and setting up) must follow the LocalAI and Ollama projects guidelines and methods.

For image generation, install Stable Diffusion from the URL github:go-skynet/model-gallery/stablediffusion.yaml, and for audio transcription, download Whisper from the URL github:go-skynet/model-gallery/whisper-base.yaml.

Host API Configuration

If the host address is different from the defaults, we need editing the script configuration file .chatgpt.conf.

vim ~/.chatgpt.conf

# Or

chatgpt.sh -F

Set the following variable:

# ~/.chatgpt.conf

OPENAI_API_HOST="http://127.0.0.1:8080"

Alternatively, set $OPENAI_API_HOST on invocation:

OPENAI_API_HOST="http://127.0.0.1:8080" chatgpt.sh -c -m luna-ai-llama2

Ollama

Visit Ollama repository, and follow the instructions to install, download models, and set up the server.

After having Ollama server running, set option -O (--ollama), and the name of the model in chatgpt.sh:

chatgpt.sh -cc -O -m llama2

If Ollama server URL is not the defaults http://localhost:11434, edit chatgpt.sh configuration file, and set the following variable:

# ~/.chatgpt.conf

OLLAMA_API_HOST="http://192.168.0.3:11434"

Google AI

Get a free API key for Google to be able to use Gemini and vision models. Users have a free bandwidth of 60 requests per minute, and the script offers a basic implementation of the API.

Set the enviroment variable $GOOGLE_API_KEY and run the script with option --google, such as:

chatgpt.sh --google -cc -m gemini-pro-vision

OBS: Google Gemini vision models are not enabled for multiturn at the API side, so we hack it.

To list all available models, run chatgpt.sh --google -l.

Mistral AI

Set up a Mistral AI account, declare the enviroment variable $MISTRAL_API_KEY, and run the script with option --mistral for complete integration.

Groq

Sign in to Groq. Create a new API key or use an existing one to set the environmental variable $GROQ_API_KEY. Run the script with option --groq.

Currently, llamma3.1 models are available at lightening speeds!

Anthropic

Sign in to Antropic AI. Create a new API key or use an existing one to set the environmental variable $ANTHROPIC_API_KEY. Run the script with option --anthropic or --ant.

Check the Claude-3 models! Run the script as:

    chatgpt.sh --anthropic -cc -m claude-3-5-sonnet-20240620

The script also works on text completions with models such as claude-2.1, although the API documentation flags it as deprecated.

Try:

    chatgpt.sh --ant -c -m claude-2.1

Arch Linux Users

This project PKGBUILD is available at the Arch Linux User Repository (AUR) to install the software in Arch Linux and derivative distros.

To install the programme from the AUR, you can use an AUR helper like yay or paru. For example, with yay:

yay -S chatgpt.sh

Termux Users

Optional Dependencies

Install the termux-api package.

For recording audio (Whisper, option -w), we defaults to termux-microphone-record and for playing audio (TTS, option -z), optionally install play-audio.

To set the clipboard, it is required termux-clipboard-set from the termux-api package.

TTS Chat - Removal of Markdown

Markdown in TTS input may stutter the model audio generation a little. If python modules markdown and bs4 are available, TTS input will be converted to plain text. As fallback, pandoc is used if present.

Tiktoken

Under Termux, make sure to have your system updated and installed with python, rust, and rustc-dev packages for building tiktoken.

pkg update

pkg upgrade

pkg install python rust rustc-dev

pip install tiktoken

🎯 Project Objectives

  • Implement nice features from OpenAI API version 1.

  • Provide the closest API defaults.

  • Let the user customise defaults (as homework).

⚠️ Limitations

  • OpenAI API version 1 is the focus of the present project implementation. Not all features of the API will be covered.

  • This project doesn't support "Function Calling" or "Structured Outputs".

  • Bash shell truncates input on \000 (null).

  • Bash "read command" may not correctly display input buffers larger than the TTY screen size during editing. However, input buffers remain unaffected. Use the text editor interface for big prompt editing.

  • Garbage in, garbage out. An idiot savant.

  • See BUGS AND LIMITS section in the man page.

Bug report

Please leave bug reports at the GitHub issues page.

📖 Help Pages

Read the online man page here.

Alternatively, a help page snippet can be printed with chatgpt.sh -h.

💪 Contributors

Many Thanks to all that contributed to this project.

edshamis

Acknowledgements

The following projects are worth remarking. They were studied during development of this script and used as referencial code sources.

  1. TheR1D's shell_gpt
  2. xenodium's chatgpt-shell
  3. llm-workflow-engine
  4. 0xacx's chatGPT-shell-cli
  5. mudler's LocalAI
  6. Ollama
  7. Google Gemini
  8. Groq
  9. Antropic AI
  10. f's awesome-chatgpt-prompts
  11. PlexPt's awesome-chatgpt-prompts-zh

Everyone is welcome to submit issues, PRs, and new ideas!


The project home is at GitLab

https://gitlab.com/fenixdragao/shellchatgpt


Mirror

https://github.com/mountaineerbr/shellChatGPT


ChatGPT by DALL-E, link to GitLab Repo

About

Shell wrapper for OpenAI's ChatGPT, DALL-E, Whisper, and TTS. Features LocalAI, Ollama, Gemini, Mistral, Groq, and Anthropic integration.

https://gitlab.com/fenixdragao/shellchatgpt

awesome-chatgpt-promptsawesome-chatgpt-prompts-zhbashchatbotdavinciterminalchat-completionstext-completionsgpt-4-visionttslocalaiollamagemini-apigemini-promistral-apigpt-4ogroqllama3claude-3

License:GNU General Public License v3.0

Languages

Language:Shell 100.0%