Instructions to use oxbyte8/SparkBotLLM-1.7B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use oxbyte8/SparkBotLLM-1.7B with PEFT:
from peft import PeftModel from transformers import AutoModelForCausalLM base_model = AutoModelForCausalLM.from_pretrained("LiquidAI/LFM3-1.7B") model = PeftModel.from_pretrained(base_model, "oxbyte8/SparkBotLLM-1.7B") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use oxbyte8/SparkBotLLM-1.7B 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 oxbyte8/SparkBotLLM-1.7B:Q4_0 # Run inference directly in the terminal: llama cli -hf oxbyte8/SparkBotLLM-1.7B:Q4_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf oxbyte8/SparkBotLLM-1.7B:Q4_0 # Run inference directly in the terminal: llama cli -hf oxbyte8/SparkBotLLM-1.7B:Q4_0
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf oxbyte8/SparkBotLLM-1.7B:Q4_0 # Run inference directly in the terminal: ./build/bin/llama cli -hf oxbyte8/SparkBotLLM-1.7B:Q4_0
Use Docker
docker model run hf.co/oxbyte8/SparkBotLLM-1.7B:Q4_0
- Llama new
- LM Studio
- Jan
- vLLM
How to use oxbyte8/SparkBotLLM-1.7B with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "oxbyte8/SparkBotLLM-1.7B" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "oxbyte8/SparkBotLLM-1.7B", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/oxbyte8/SparkBotLLM-1.7B:Q4_0
- Ollama
How to use oxbyte8/SparkBotLLM-1.7B with Ollama:
ollama run hf.co/oxbyte8/SparkBotLLM-1.7B:Q4_0
- Unsloth Desktop
- Pi
How to use oxbyte8/SparkBotLLM-1.7B with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf oxbyte8/SparkBotLLM-1.7B:Q4_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": "oxbyte8/SparkBotLLM-1.7B:Q4_0" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use oxbyte8/SparkBotLLM-1.7B with Docker Model Runner:
docker model run hf.co/oxbyte8/SparkBotLLM-1.7B:Q4_0
- Lemonade
How to use oxbyte8/SparkBotLLM-1.7B with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull oxbyte8/SparkBotLLM-1.7B:Q4_0
Run and chat with the model
lemonade run user.SparkBotLLM-1.7B-Q4_0
List all available models
lemonade list
- Hermes Agent
How to use oxbyte8/SparkBotLLM-1.7B with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf oxbyte8/SparkBotLLM-1.7B:Q4_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 oxbyte8/SparkBotLLM-1.7B:Q4_0
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use oxbyte8/SparkBotLLM-1.7B with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf oxbyte8/SparkBotLLM-1.7B:Q4_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 "oxbyte8/SparkBotLLM-1.7B:Q4_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"
Add SparkBotLLM setup, adaptation and validation writeup
Browse files
README.md
CHANGED
|
@@ -8,11 +8,19 @@ license_link: LICENSE
|
|
| 8 |
language: [en]
|
| 9 |
pipeline_tag: text-generation
|
| 10 |
---
|
| 11 |
-
# SparkBotLLM 1.7B
|
| 12 |
|
| 13 |
A local assistant for DGX Spark setup and local inference, adapted from LiquidAI LFM3 1.7B. Sparkbot supplies the live inspection tools, reviewed actions and dated support references. Model inference can run privately on CPU with a 4K context and one request at a time.
|
| 14 |
|
| 15 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 16 |
|
| 17 |
## Files and use
|
| 18 |
|
|
@@ -24,6 +32,12 @@ Run with a recent LFM3-capable llama.cpp server, for example:
|
|
| 24 |
llama-server --model SparkBotLLM-1.7B-Q4_0.gguf --alias SparkBotLLM --host 127.0.0.1 --port 10004 --ctx-size 4096 --parallel 1 --threads 4 --n-gpu-layers 0 --jinja --chat-template-kwargs '{"enable_thinking":false}'
|
| 25 |
```
|
| 26 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 27 |
## Adaptation and checks
|
| 28 |
|
| 29 |
242 authored synthetic support examples, 44 dated support references, LoRA rank 8/alpha 16, assistant-only loss, AdamW learning rate 0.00005. A 192-step run selected step 128 by lowest validation loss. Six domain validation examples were used for selection: mean loss fell from 4.62 to 3.32. They are not an independent test set. Five independent Q4 tool-routing smoke checks passed after export. These narrow checks do not establish broad factual accuracy, safety or reliability. Peak training CUDA allocation was 3.59 GiB. Reports are included.
|
|
|
|
| 8 |
language: [en]
|
| 9 |
pipeline_tag: text-generation
|
| 10 |
---
|
| 11 |
+
# SparkBotLLM 1.7B
|
| 12 |
|
| 13 |
A local assistant for DGX Spark setup and local inference, adapted from LiquidAI LFM3 1.7B. Sparkbot supplies the live inspection tools, reviewed actions and dated support references. Model inference can run privately on CPU with a 4K context and one request at a time.
|
| 14 |
|
| 15 |
+
SparkBotLLM helps you take the next step with your Spark: check a setup, understand a deployment requirement, or inspect a problem before changing anything. The surrounding Sparkbot dashboard gives it hardware inspection and terminal tools, with owner review for changes.
|
| 16 |
+
|
| 17 |
+
For current releases, use discovery tools and primary sources. For live clocks, memory and Docker status, use hardware tools. The weights alone cannot inspect your machine.
|
| 18 |
+
|
| 19 |
+
## Getting started
|
| 20 |
+
|
| 21 |
+
The model is designed for the [Sparkbot dashboard](https://github.com/x00byte/DGX-Sparkbot). The dashboard and website installation package are being prepared for release; the source repository is currently private. You can run the GGUF independently with a current LFM3-capable llama.cpp build using the command below. No Docker or GPU is required for CPU inference.
|
| 22 |
+
|
| 23 |
+
Download the GGUF from **Files and versions**. It is approximately 1.05 GB. Start with a 4K context, four CPU threads and one request at a time. This keeps the helper small while your main model uses the GPU.
|
| 24 |
|
| 25 |
## Files and use
|
| 26 |
|
|
|
|
| 32 |
llama-server --model SparkBotLLM-1.7B-Q4_0.gguf --alias SparkBotLLM --host 127.0.0.1 --port 10004 --ctx-size 4096 --parallel 1 --threads 4 --n-gpu-layers 0 --jinja --chat-template-kwargs '{"enable_thinking":false}'
|
| 33 |
```
|
| 34 |
|
| 35 |
+
## What changed
|
| 36 |
+
|
| 37 |
+
The base model received a short supervised adaptation focused on DGX Spark support, local inference concepts and choosing the right inspection tool. The application also supplies a dated reference pack; that reference material can be updated independently of the model.
|
| 38 |
+
|
| 39 |
+
SparkBotLLM is intended to explain requirements, diagnose issues and propose useful next steps. Shell access and deployment automation come from the host application, not from the model file itself.
|
| 40 |
+
|
| 41 |
## Adaptation and checks
|
| 42 |
|
| 43 |
242 authored synthetic support examples, 44 dated support references, LoRA rank 8/alpha 16, assistant-only loss, AdamW learning rate 0.00005. A 192-step run selected step 128 by lowest validation loss. Six domain validation examples were used for selection: mean loss fell from 4.62 to 3.32. They are not an independent test set. Five independent Q4 tool-routing smoke checks passed after export. These narrow checks do not establish broad factual accuracy, safety or reliability. Peak training CUDA allocation was 3.59 GiB. Reports are included.
|