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"
Getting a powerful model running locally should feel approachable. SparkBotLLM gives DGX Spark owners a small assistant to help them get there: understand their hardware, work through setup, choose a deployment profile and troubleshoot the next step.
It is the local assistant inside Sparkbot, a dashboard for managing NVIDIA DGX Sparks. The idea is simple: start with a compact AI helper on your own machine, then use it to help deploy and manage larger local models. Beginners get clear guidance. Experienced users keep access to their terminal and configuration.
Small enough to stay alongside your main model
| SparkBotLLM | |
|---|---|
| Base | LiquidAI LFM3 1.7B |
| Download | Approximately 1.05 GB, Q4_0 GGUF |
| Default execution | Local CPU, four threads, one request at a time |
| Serving context | 4,096 tokens |
| Sparkbot runtime | 9.2 MB native CPU package; no Docker or PyTorch required |
| Helper endpoint | 127.0.0.1:10004 |
| Dashboard | Port 10005 |
CPU inference leaves GPU execution available for your main model. CPU work and unified-memory traffic still share the Sparkโs resources. The dashboard caps its helper service at 3 GiB; that is a configured limit, not a claim of measured resident memory.
From a question to a useful next step
Inside Sparkbot, the assistant can use tools to inspect Docker support, GPU clocks, memory and connections; discover new models; explain deployment requirements; and propose terminal commands. Changes wait for owner approval. Administrator passwords are entered in the dashboardโs approval flow and are not sent to the model.
A typical journey is to check the Spark, resolve a missing dependency, select a bundled recipe, then monitor the running model and compare decode or prefill results. SparkBotLLM stays beside that workflow as local help.
The dashboard supplies these tools and controls. Running the model file alone gives you a chat model; it does not grant shell access, fetch current releases or deploy models by itself. Model inference runs locally. Downloads and online discovery contact their respective sources.
Run it today
Download SparkBotLLM-1.7B-Q4_0.gguf from Files and versions. It is public and needs no access request. Use a current LFM3-capable llama.cpp build:
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}'
The GGUF includes the chat template. Start with a 4K context and short, tool-assisted turns. The Sparkbot website package also includes a compact runtime and guided setup. sparkbot.dev is the planned home; its hosting and domain connection are being prepared. The model can already be downloaded and run independently.
What we adapted
SparkBotLLM received a short supervised LoRA adaptation focused on DGX Spark support, local inference and choosing the appropriate inspection tool. The training set contains 242 authored synthetic support examples, informed by 44 dated support references. It contains no private user chats or credentials.
Sparkbot also supplies relevant support references at runtime. This lets documentation evolve separately from the weights. Live hardware facts come from inspection tools; new software and model releases should come from current primary sources.
| Training detail | Value |
|---|---|
| Exact base revision | ac2586a34f1a1c03329dbdcdefabd8b6478ddaa7 |
| LoRA | Rank 8, alpha 16 |
| Optimizer | AdamW, learning rate 0.00005 |
| Loss | Assistant tokens only |
| Selected checkpoint | Step 128 of a 192-step run |
| Peak CUDA allocation during training | 3.59 GiB |
The adapter was merged into that exact BF16 base before Q4_0 conversion, with Q6_K token embeddings. Do not apply this adapter to LiquidAIโs separate QAD quantized checkpoint.
Checks and practical limits
Six domain validation examples were used for checkpoint selection. Mean loss fell from 4.62 to 3.32. Because they guided selection, these are validation results, not an independent final test. After Q4 export, five independent tool-routing smoke checks passed, covering hardware inspection, clocks, setup, recipes and model discovery. Reports are included in this repository.
These are narrow checks. They do not establish broad factual accuracy or reliable deployment automation. SparkBotLLM is a small model and can make mistakes. Keep command review enabled, verify important guidance, and use tools for live measurements. Long-context quality beyond the 4K serving profile has not been evaluated.
License and credits
SparkBotLLM is an adaptation of LiquidAI LFM3 1.7B, not a model trained from scratch. The retained LFM Open License v1.0 applies, including its commercial conditions.
LiquidAI supplies the base weights and architecture. PyTorch, Transformers and PEFT support training; llama.cpp supplies GGUF conversion and the compact CPU backend. Support references credit NVIDIA, Docker, TensorFold and the relevant model publishers. Sparkbot integration and supplied branding are by x00byte. Sparkbot is an independent project for DGX Spark owners, with no NVIDIA endorsement claimed.
- Downloads last month
- 1
4-bit