Text Generation
GGUF
English
agentic
agent
tool-use
function-calling
code
terminal
swe
qwen3.5
small-models
edge
llama.cpp
ollama
conversational
Instructions to use Hob-forge/smeagle-4b 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 Hob-forge/smeagle-4b 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 Hob-forge/smeagle-4b:Q4_K_M # Run inference directly in the terminal: llama cli -hf Hob-forge/smeagle-4b:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Hob-forge/smeagle-4b:Q4_K_M # Run inference directly in the terminal: llama cli -hf Hob-forge/smeagle-4b:Q4_K_M
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 Hob-forge/smeagle-4b:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf Hob-forge/smeagle-4b:Q4_K_M
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 Hob-forge/smeagle-4b:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Hob-forge/smeagle-4b:Q4_K_M
Use Docker
docker model run hf.co/Hob-forge/smeagle-4b:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use Hob-forge/smeagle-4b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Hob-forge/smeagle-4b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Hob-forge/smeagle-4b", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Hob-forge/smeagle-4b:Q4_K_M
- Ollama
How to use Hob-forge/smeagle-4b with Ollama:
ollama run hf.co/Hob-forge/smeagle-4b:Q4_K_M
- Unsloth Studio
How to use Hob-forge/smeagle-4b with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Hob-forge/smeagle-4b to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Hob-forge/smeagle-4b to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Hob-forge/smeagle-4b to start chatting
- Pi
How to use Hob-forge/smeagle-4b with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Hob-forge/smeagle-4b:Q4_K_M
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": "Hob-forge/smeagle-4b:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use Hob-forge/smeagle-4b with Docker Model Runner:
docker model run hf.co/Hob-forge/smeagle-4b:Q4_K_M
- Lemonade
How to use Hob-forge/smeagle-4b with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Hob-forge/smeagle-4b:Q4_K_M
Run and chat with the model
lemonade run user.smeagle-4b-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use Hob-forge/smeagle-4b with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Hob-forge/smeagle-4b:Q4_K_M
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 Hob-forge/smeagle-4b:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use Hob-forge/smeagle-4b with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Hob-forge/smeagle-4b:Q4_K_M
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 "Hob-forge/smeagle-4b:Q4_K_M" \ --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"
Card: correct Honest Limits after stability reruns (self-ref was temp-noise, not a failure); v0.1 stays recommended over v0.2
Browse files
README.md
CHANGED
|
@@ -109,27 +109,31 @@ over your system message or tool calls.
|
|
| 109 |
## Honest limits β where it actually breaks
|
| 110 |
|
| 111 |
We pushed it with a **hard trap-suite** (10 tasks built specifically to make a strong 4B fail β 8-hop
|
| 112 |
-
dependent chains, an RPN evaluator, byte-exact files, self-referential puzzles)
|
| 113 |
-
|
|
|
|
| 114 |
|
| 115 |
- **Byte-exact / multi-line formatting.** Told to write four exact lines with trailing spaces and no final
|
| 116 |
-
newline, it collapsed them onto one line. It
|
| 117 |
-
- **Self-referential / fixed-point reasoning.** "Write a sentence that says how many words it has" β it wrote
|
| 118 |
-
"β¦has 1 word" (the true answer is 5). Puzzles whose answer depends on the answer trip it up.
|
| 119 |
- **Operand-order-sensitive code.** In a generated RPN evaluator it got the subtract/divide order wrong
|
| 120 |
(`a op b` vs `b op a`) β the classic bug. Review order-sensitive logic it writes.
|
| 121 |
-
- **Long single-file running state.** Overwriting one file with a running value across many steps, it
|
| 122 |
-
|
|
|
|
|
|
|
|
|
|
| 123 |
|
| 124 |
-
What it *does* do well
|
| 125 |
-
|
| 126 |
-
logic, recognizing a tool's limits
|
| 127 |
|
| 128 |
- It's **4B** β a frontier model beats it on hard long-horizon work; smeagle's job is to be the *capable
|
| 129 |
little one that fits*, not to out-muscle models 100Γ its size. And it's a **specialist** (agentic/terminal/
|
| 130 |
SWE), not a generalist oracle.
|
| 131 |
-
- v0.1
|
| 132 |
-
|
|
|
|
|
|
|
| 133 |
|
| 134 |
## License & rules β free for almost everyone
|
| 135 |
|
|
|
|
| 109 |
## Honest limits β where it actually breaks
|
| 110 |
|
| 111 |
We pushed it with a **hard trap-suite** (10 tasks built specifically to make a strong 4B fail β 8-hop
|
| 112 |
+
dependent chains, an RPN evaluator, byte-exact files, self-referential puzzles) and re-ran the flaky ones
|
| 113 |
+
several times so we'd report *reliable* behaviour, not a lucky single draw. The genuine limits β double-check
|
| 114 |
+
it on these:
|
| 115 |
|
| 116 |
- **Byte-exact / multi-line formatting.** Told to write four exact lines with trailing spaces and no final
|
| 117 |
+
newline, it collapsed them onto one line. It *normalizes* formatting β if you need bytes exactly, verify.
|
|
|
|
|
|
|
| 118 |
- **Operand-order-sensitive code.** In a generated RPN evaluator it got the subtract/divide order wrong
|
| 119 |
(`a op b` vs `b op a`) β the classic bug. Review order-sensitive logic it writes.
|
| 120 |
+
- **Long single-file running state.** Overwriting one file with a running value across many steps, it loses
|
| 121 |
+
the thread (0/3 in our reruns). Give it distinct filenames or fewer hops when precision matters.
|
| 122 |
+
- **Temperature-sensitive on one-shot precision.** Some exact/self-referential tasks it gets right *most*
|
| 123 |
+
of the time but not every time (e.g. "write a sentence stating its own word count" β ~2 in 3 at default
|
| 124 |
+
temp 0.6). If you need it reliable in one shot, lower the temperature or let it retry.
|
| 125 |
|
| 126 |
+
What it *does* do well: the full agentic suite (16/16 β single-tool β multi-tool chains β file ops β
|
| 127 |
+
code-gen+verify β error recovery β constrained output), plus long dependent tool-chains, building larger
|
| 128 |
+
working modules with correct logic, and recognizing a tool's limits.
|
| 129 |
|
| 130 |
- It's **4B** β a frontier model beats it on hard long-horizon work; smeagle's job is to be the *capable
|
| 131 |
little one that fits*, not to out-muscle models 100Γ its size. And it's a **specialist** (agentic/terminal/
|
| 132 |
SWE), not a generalist oracle.
|
| 133 |
+
- **Why v0.1 and not v0.2?** We built a v0.2 and benchmarked both, in the open, on all 26 tasks with reruns.
|
| 134 |
+
v0.2's apparent edge turned out to be temperature noise once repeated β no *reliable* agentic gain β and it
|
| 135 |
+
regressed slightly on held-out SWE loss. So v0.1 stays the recommended release. That's the honest call, and
|
| 136 |
+
we'll only ship a v0.2 when it clearly earns it.
|
| 137 |
|
| 138 |
## License & rules β free for almost everyone
|
| 139 |
|