Skip to main content

Lightweight TUI manager for llama.cpp models on Raspberry Pi

Project description

llama-tui

CLI manager for llama.cpp. Detects hardware, downloads models, launches optimized servers. Specifically made for raspberry pi devices.

Requirements

  • Raspberry Pi OS (any model, x64/x86_64 recommended)
  • Python 3.14+
  • uv
  • llama-server (compiled with BLIS + NEON)
  • hf CLI (huggingface-hub, authenticated)

Install

uv tool install llama-tui

Setup

llama-tui setup 	# detect hardware, select models
llama-tui download 	# fetch enabled models
llama-tui prep 		# system tuning (swap, governor, hugepages)

Serve

llama-tui serve --role chat

Other Commands

llama-tui models 	# list enabled models
llama-tui rpc 		# check remote RPC connectivity
llama-tui status 	# full system & config summary
llama-tui restore 	# revert system tuning
llama-tui swap 		# show swap status

Optional RPC

On a second Pi, run:

rpc-server --host <hostname> --port 50052

Enable RPC during setup or edit ~/.config/llama-tui/config.toml.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llama_tui-0.1.1.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

llama_tui-0.1.1-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file llama_tui-0.1.1.tar.gz.

File metadata

  • Download URL: llama_tui-0.1.1.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for llama_tui-0.1.1.tar.gz
Algorithm Hash digest
SHA256 051a38efc65551f44d9d6c5f217e6779f8bef902880fc986d30ceaafe45b6438
MD5 59dfd2e4149f62a1267dd1fd22854d56
BLAKE2b-256 efe5462677d4d2dcb4b9fe35264a4eb3c917ffe8698a11a6dd625bf525b3b320

See more details on using hashes here.

File details

Details for the file llama_tui-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: llama_tui-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for llama_tui-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d159446425cadbc56cca7652c14812cb7eefad0b34958d0d71c9eb1ab3b1957a
MD5 9fe30538017be496b4af9a1119d93350
BLAKE2b-256 892911df926faa4906ac331734857fc1bc3beb625004ba7b83b7d040b4911cc8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page