halp

halp is a command line tool that provides AI assistance for your terminal workflows. It connects to an OpenAI-compatible endpoint (e.g., Open WebUI, OpenAI).

Features

• Simple configuration via ~/.halp.env
• OpenAI-compatible model listing via /v1/models
• CLI overrides for base URL, API key, and model
• Verbose and debug logging
• Secure config file permissions (0600)
• Interactive first-run setup

Requirements

• Python 3.8+

Configuration

halp stores configuration in ~/.halp.env. If the file doesn’t exist, the CLI will guide you through a short setup:

BASE_URL=
API_KEY=
DEFAULT_MODEL=

Installation

Ensure pipx is installed

sudo apt install -y pipx
pipx ensurepath
#restart shell
pipx install git+https://github.com/ABVStudio-net/halp.git

which halp
halp --version
halp -h

Usage

• Print help:

  halp --help

• Interactive setup:

  halp --init

• Print current configuration:

  halp --print-config

• List available models from the configured endpoint:

  halp -l

• Override model for a single run:

  halp -m hf.co/unsloth/Qwen3-Coder-30B-A3B-Instruct-GGUF:Q8_K_XL

Development

• Editable install during development:

  pipx install --editable .

• Uninstall:

  pipx uninstall halp