
## A versatile Go‑based command‑line interface for interacting with AI models (text generation, speech‑to‑text, image generation)
--- 

- **Primary purpose:** Enable developers & content creators to call AI services directly from the terminal.  
- **Core features**  
  - Text generation via OpenAI GPT‑3 (or any configured model)  
  - Speech‑to‑text conversion  
  - Image generation from prompts  
  - Extensible plug‑in architecture (e.g., web‑search agent)  
- **UI framework:** Built with **Charm Bubble Tea** to provide a smooth, interactive terminal UI (REPL, shortcut hints, dynamic updates).  
- **Tech stack** – Go 1.20, Cobra CLI framework, Viper for configuration, PromptUI, Docker (multi‑stage builds), GitHub Actions + GoReleaser for CI/CD, optional `portaudio` tag for audio support.  
- **Installation** – `go install github.com/MohammadBnei/go‑ai‑cli@latest` (or with `-tags portaudio`); pre‑compiled binaries available on the Releases page.  
- **Configuration** – API key & model stored in `$HOME/.go‑ai‑cli.yaml`; CLI helpers to list/set values.  
- **Usage example** – `go‑ai‑cli prompt` launches an interactive REPL; shortcuts: `Ctrl‑D` (quit), `Ctrl‑H` (help), `Ctrl‑G` (options), `Ctrl‑F` (attach file).  
- **Open‑source stats** – ★ 6, 🍴 2, 3 branches, 37 tags; latest release 0.18.8 (18 Mar 2024).  
- **License** – MIT.  