LLM Shell Agent

A lightweight shell agent powered by local LLMs.
Convert natural language instructions into Linux shell commands and execute them directly.

---

Demo

See the demo video:

---

Features

• Natural language to shell command conversion using a local LLM
• Colorful CLI interface with rich
• Dry-run mode for safe demonstrations

---

Quickstart

1. Clone and build

git clone https://github.com/black-leg-nameko/llmshell-agent.git
cd llmshell-agent
docker compose build

2. Download a model

Place a GGUF model into the model/ directory. For example,

curl -L -o model/tinyllama-1.1b-chat-v1.0.Q4_K_M.gguf \
  https://huggingface.co/TheBloke/TinyLlama-1.1B-Chat-v1.0-GGUF/resolve/main/tinyllama-1.1b-chat-v1.0.Q4_K_M.gguf

3. Run

Interactive mode:

docker compose run llmshell python app/main.py

One-shot execution:

docker compose run llmshell python app/main.py "Show current directory" --dry-run