Instructions to use TessaCoil/K3-Stuff with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use TessaCoil/K3-Stuff with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf TessaCoil/K3-Stuff:Q8_0 # Run inference directly in the terminal: llama cli -hf TessaCoil/K3-Stuff:Q8_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf TessaCoil/K3-Stuff:Q8_0 # Run inference directly in the terminal: llama cli -hf TessaCoil/K3-Stuff:Q8_0
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf TessaCoil/K3-Stuff:Q8_0 # Run inference directly in the terminal: ./llama-cli -hf TessaCoil/K3-Stuff:Q8_0
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf TessaCoil/K3-Stuff:Q8_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf TessaCoil/K3-Stuff:Q8_0
Use Docker
docker model run hf.co/TessaCoil/K3-Stuff:Q8_0
- LM Studio
- Jan
- Ollama
How to use TessaCoil/K3-Stuff with Ollama:
ollama run hf.co/TessaCoil/K3-Stuff:Q8_0
- Unsloth Desktop
- Pi
How to use TessaCoil/K3-Stuff with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf TessaCoil/K3-Stuff:Q8_0
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "TessaCoil/K3-Stuff:Q8_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use TessaCoil/K3-Stuff with Docker Model Runner:
docker model run hf.co/TessaCoil/K3-Stuff:Q8_0
- Lemonade
How to use TessaCoil/K3-Stuff with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull TessaCoil/K3-Stuff:Q8_0
Run and chat with the model
lemonade run user.K3-Stuff-Q8_0
List all available models
lemonade list
- Hermes Agent
How to use TessaCoil/K3-Stuff with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf TessaCoil/K3-Stuff:Q8_0
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default TessaCoil/K3-Stuff:Q8_0
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use TessaCoil/K3-Stuff with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf TessaCoil/K3-Stuff:Q8_0
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "TessaCoil/K3-Stuff:Q8_0" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
| # k3-test/run_all.sh — full runbook driver (plan §4 Phases 0–3). | |
| # Usage: | |
| # tmux new -s k3 | |
| # ./run_all.sh # everything, K3 download starts in background immediately | |
| # SKIP_DOWNLOAD=1 ./run_all.sh # if K3 already downloaded | |
| SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" | |
| source "$SCRIPT_DIR/lib/common.sh" | |
| trap 'stop_monitors; unfill_ram' EXIT | |
| info "k3-test run starting. Logs: $LOG_ROOT" | |
| # ---- Phase 0: setup + kick the big download OFF in the background ------------ | |
| "$SCRIPT_DIR/setup.sh" 2>&1 | tee "$LOG_ROOT/setup.log" | |
| if [[ -z "${SKIP_DOWNLOAD:-}" ]]; then | |
| info "launching K3 download in background ($K3_INCLUDE, ~1.5 TB)…" | |
| nohup "$SCRIPT_DIR/01_download_k3.sh" > "$LOG_ROOT/download_k3.log" 2>&1 & | |
| DL_PID=$! | |
| echo "$DL_PID" > "$LOG_ROOT/download_k3.pid" | |
| fi | |
| "$SCRIPT_DIR/02_download_smoke.sh" 2>&1 | tee -a "$LOG_ROOT/download_smoke.log" | |
| # ---- Phase 0b: recon (free, while downloading) -------------------------------- | |
| "$SCRIPT_DIR/00_recon.sh" 2>&1 | tee "$LOG_ROOT/recon_driver.log" | |
| # ---- Phase 1: smoke gate ------------------------------------------------------- | |
| if ! "$SCRIPT_DIR/10_smoke.sh" 2>&1 | tee "$LOG_ROOT/smoke_driver.log"; then | |
| die "SMOKE GATE FAILED — investigate logs in $LOG_ROOT before spending more" | |
| fi | |
| # ---- gate: wait for K3 ---------------------------------------------------------- | |
| if [[ -n "${DL_PID:-}" ]]; then | |
| info "waiting for K3 download (pid $DL_PID) — tail -f $LOG_ROOT/download_k3.log to watch" | |
| while kill -0 "$DL_PID" 2>/dev/null; do | |
| du -sh "${MODEL_DIR:-$HOME/models}/Kimi-K3-GGUF" 2>/dev/null | tr '\n' ' ' | |
| df -h . | tail -1 | awk '{print " free:",$4}' | |
| sleep 120 | |
| done | |
| wait "$DL_PID" || die "K3 download FAILED — check $LOG_ROOT/download_k3.log" | |
| fi | |
| # ---- Phase 2: experiments ------------------------------------------------------- | |
| "$SCRIPT_DIR/20_k3_experiments.sh" 2>&1 | tee "$LOG_ROOT/experiments_driver.log" | |
| # ---- Phase 3: pack -------------------------------------------------------------- | |
| "$SCRIPT_DIR/30_teardown.sh" | |
| cat <<EOF | |
| ================================================================================ | |
| RUN COMPLETE. Sync $LOG_ROOT and the tarball off-box, then DESTROY the instance. | |
| Report against k3-rental-test-plan.md §6 success criteria. | |
| ================================================================================ | |
| EOF | |