README.md

AI - a commandline LLM chat client in BASH with conversation/completion and image generation support

Features:

• Supports any OpenAI-compatible API endpoint, both local and remote

  • OpenAI
  • Gemini
  • Grok
  • HuggingFace
  • OpenRouter
  • LM Studio
  • Ollama
  • and many more

• Interactive chat sessions

• Multiline input

• Image generation support: (currently limited to DALL·E 2)

  • 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)

• Single turn Q&A with optional follow-up conversation

• Data piping support (sending file contents to the LLM)

• 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

• Multiple chat models support:

  • switch to a different model mid-conversation
  • can freely combine local and remote models
  • a single tool to query any model served through an OpenAI-compatible API endpoint

Full command line options (ai -h):

Manage models (add/delete/set default):

ai -m

Start a new interactive conversation:

ai [-m <modelname>]

Single turn Q&A (will ask you to continue interacting, otherwise quit after answer):

ai [-m <modelname>] "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 [-m <modelname>] can you summarize the contents of this file?

List saved conversations:

ai -l

Continue last conversation:

ai -c

Continue specific conversation:

ai -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/.config/ai-bash/conversations.json"

Usage examples:

(Adding a model)

(Listing added models)

(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

• 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/master/ai" > /usr/bin/ai && chmod 0755 /usr/bin/ai