GitHub Repository

Bash-first wrapper for Groq’s OpenAI-compatible API. Secure, portable, Termux-friendly.

5 starsShell

Bash4LLM+ – A lightweight, dependency-free Bash wrapper for LLM APIs

Name: Bash4LLM+ – A lightweight, dependency-free Bash wrapper for LLM APIs
Availability: InStock
Author: kamaludu

by kamaludu·Jun 28, 2026·12 points·8 comments

Visit Project View on HN

AI Analysis

●●SolidCozyNiche Gem

Pure Bash LLM wrapper with no Python runtime needed.

Strengths

•Termux-ready with atomic directory locks bypassing unstable flock on Android
•Security-conscious design with no eval, no tmp, restricted permissions
•Dynamic model listing via API instead of hardcoded model names

Weaknesses

•CLI LLM wrappers already exist like llm, sgpt, and other tools
•Groq-first focus limits provider flexibility out of the box

Post Description

Bash4LLM is a single-file Bash wrapper for interacting with LLMs from the terminal. I created it because I wanted something simple that worked without installing Python, Node, or any other runtime.

It uses only Bash, curl, and jq. You can send prompts, start a small chat, process files line by line, stream output, and save session metadata in JSON format.

I tried to make it safe and predictable: no use of the system /tmp, no use of eval. Groq is supported by default, and other providers can be added with dedicated Bash scripts in the extras/providers/ folder.

Example:

echo "explains the command: ls -l" | ./bash4llm