Installation

llamdrop installs in a single command. No compilation. No configuration. No account needed.

---

Requirements

• Python 3.8 or later
• A terminal:
  • Android: Termux from F-Droid (not Play Store)
  • Linux: Any distro with bash
  • Raspberry Pi: Raspberry Pi OS or any ARM64 Linux
  • Chromebook: Linux mode (Crostini)
• Internet connection for install and first model download

---

Install

Android (Termux) / Linux / Raspberry Pi:

curl -sL https://raw.githubusercontent.com/DeVenLucaz/llamdrop/main/install.sh | bash

Then run:

llamdrop

The installer handles everything: Python packages, the correct llama.cpp binary for your platform and GPU, model catalog, working directory, and PATH setup.

---

Termux-Specific Setup

pkg update -y
pkg install curl -y
termux-setup-storage  # grants storage access for phone-wide GGUF scanning

Install Termux from F-Droid, not the Play Store — the Play Store version is outdated.

---

CLI Commands

llamdrop          # Open interactive menu
llamdrop update   # Update to latest version from GitHub
llamdrop doctor   # Check your install for issues
llamdrop version  # Show current version
llamdrop help     # Show available commands

---

Updating

llamdrop update

Shows what changed, asks for confirmation, pulls all code files. Your downloaded models, sessions, and config are never touched. You can also independently update the inference engine from the main menu using [Update Engine].

---

Uninstall

rm -rf ~/.llamdrop
rm -f $PREFIX/bin/llamdrop    # Termux
# or
rm -f ~/.local/bin/llamdrop   # Linux