rkllama

Manage RKLLama model lifecycle on RK3588 NPUs with node pinning and explicit unload/load workflows.

32|5|Updated Oct 6, 2024
One-click install
npx skills add https://github.com/gilesknap/tpi-k3s-ansible --skill rkllama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rkllama
Source: https://github.com/gilesknap/tpi-k3s-ansible/tree/main/.claude/skills/rkllama
Command: npx skills add https://github.com/gilesknap/tpi-k3s-ansible --skill rkllama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

RKLLama provides reliable operations for RKLLama on RK3588 NPUs with node pinning, clear model lifecycle management, and visibility into silent-failure modes of rkllama_client pull.

Core Features & Use Cases

  • In-pod CLI access via rkllama_client with a known path and host-side wrappers for convenience.
  • Clear model lifecycle: pinning to node04, explicit unloads before loading new models, and rules for one model per NPU.
  • Guidance on hardware envelope, quant settings, and model conversions for deployment and maintenance.

Quick Start

Inspect the current RKLLama deployment and unload any active model to prepare for a new load.

Frequently Asked Questions about rkllama

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage LLM model lifecycle on RK3588 NPU in Kubernetes?

You can manage the LLM lifecycle on an RK3588 NPU by using explicit unload and load workflows, ensuring a strict one-model-per-NPU constraint to switch models safely within your Kubernetes deployment.

How do I pin a Kubernetes node for RKLLama NPU workloads?

Pinning a Kubernetes node for RKLLama ensures reliable operations by dedicating specific hardware, such as node04, to run the RKLLama workload and manage its per-node model state.

Can I use rkllama_client inside a pod to pull and load models?

Yes, you can use rkllama_client via known in-pod command paths to pull and load models, utilizing host-side wrappers and NFS-backed model storage directories for reliable access.

Why does rkllama_client pull silently fail when loading a new model?

Silent failures during a pull or load often occur when the one-model-per-NPU constraint is violated; explicitly unloading the active model before loading a new one resolves this issue.

What are the constraints for deploying RK3588 NPU models with NFS storage?

Deploying RK3588 NPU models with NFS storage requires adhering to model directory conventions, applying strict one-model-per-NPU limits, and configuring appropriate quant settings for the hardware envelope.