Skip to content
TakoAPI
Back to skills

homelab-cluster

by mlesnews

DevOps & Cloud
609Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Manage multi-tier AI inference clusters for homelabs.

Description

What This Skill Does

Manages multi-tier AI inference clusters for homelab environments. Covers health monitoring across GPU and CPU nodes, MoE-based request routing, automatic recovery for downed nodes, and model deployment via Ollama and llama.cpp. Includes GPU memory planning, Docker volume strategies, and a unified LiteLLM API gateway.

Consolidates health checks, failover routing, and node recovery into one workflow instead of managing each Ollama or llama.cpp instance separately.

When to Use It

  • Routing coding tasks to a dedicated coder model on the local GPU node
  • Recovering a remote Docker Desktop crash without manual intervention
  • Planning which quantized models fit within 24GB VRAM across a cluster
  • Restarting GPU containers sequentially to avoid CUDA initialization deadlocks
  • Exposing all cluster models through a single OpenAI-compatible endpoint

Example Workflow

INPUT

User asks: route this code review request to the best available model

AGENT
  1. 1

    Classify the prompt as a 'code' task

  2. 2

    Query the health endpoint for the designated coder model node

  3. 3

    If healthy, return the coder model endpoint; if degraded, check fallback tier

  4. 4

    Select next-best available model from health results

  5. 5

    Return the chosen model endpoint and tier metadata to the caller

OUTPUT

Request routed to remote/mark-i running Qwen2.5-Coder-7B at full GPU capacity

Requirements

  • SSH access credentials stored in a vault (e.g., Azure Key Vault or HashiCorp Vault) for remote node recovery

Installation

clawhub install mlesnews/homelab-cluster

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links