Safetensors
GGUF
English
Russian
lfm3
reasoning
test-time-compute
inference-time-scaling
code-generation
llama.cpp
negative-results
conversational
Instructions to use HelioAI/LFM3-1.7B-inference-modules-experiments 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 HelioAI/LFM3-1.7B-inference-modules-experiments 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 HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M # Run inference directly in the terminal: llama cli -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M # Run inference directly in the terminal: llama cli -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
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 HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M # Run inference directly in the terminal: ./build/bin/llama cli -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
Use Docker
docker model run hf.co/HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
- Llama new
- LM Studio
- Jan
- Ollama
How to use HelioAI/LFM3-1.7B-inference-modules-experiments with Ollama:
ollama run hf.co/HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
- Unsloth Desktop
- Pi
How to use HelioAI/LFM3-1.7B-inference-modules-experiments with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_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": "HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use HelioAI/LFM3-1.7B-inference-modules-experiments with Docker Model Runner:
docker model run hf.co/HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
- Lemonade
How to use HelioAI/LFM3-1.7B-inference-modules-experiments with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
Run and chat with the model
lemonade run user.LFM3-1.7B-inference-modules-experiments-Q5_K_M
List all available models
lemonade list
- Hermes Agent
How to use HelioAI/LFM3-1.7B-inference-modules-experiments with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_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 HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use HelioAI/LFM3-1.7B-inference-modules-experiments with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_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 "HelioAI/LFM3-1.7B-inference-modules-experiments:Q5_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"
Download research/scripts/build_sft.py from HelioAI/LFM3-1.7B-inference-modules-experiments: direct link, hf CLI and curl.
- Browser
- Download file 4.47 kB
-
https://huggingface.co/HelioAI/LFM3-1.7B-inference-modules-experiments/resolve/main/research/scripts/build_sft.py
- Command line
-
hf download hf://HelioAI/LFM3-1.7B-inference-modules-experiments/research/scripts/build_sft.py
-
curl -L -o build_sft.py https://huggingface.co/HelioAI/LFM3-1.7B-inference-modules-experiments/resolve/main/research/scripts/build_sft.py
4.47 kB
| """Builds the SFT set from teach_gen.py output: what the module system knows how to do, as plain model outputs. | |
| Per problem (one example each, so easy problems do not dominate): | |
| * "short": the shortest correct natural solution among the N samples (efficient reasoning that still ends right); | |
| * "stop": if no natural sample is shorter, a checked stop example (thinking cut where the answer was already | |
| known and stable + </think> + the model's own closing answer) — teaches ending the thinking on time. | |
| usage: build_sft.py --inp results/teach/pilot.jsonl --items data/teach/*.jsonl --out data/teach/sft_pilot.jsonl | |
| """ | |
| import argparse | |
| import collections | |
| import glob | |
| import json | |
| import zlib | |
| from transformers import AutoTokenizer | |
| EOS = 124900 | |
| ap = argparse.ArgumentParser() | |
| ap.add_argument("--inp", nargs="+", required=True) | |
| ap.add_argument("--items", default="data/teach/*.jsonl") | |
| ap.add_argument("--out", required=True) | |
| ap.add_argument("--tokenizer", default="models/LFM3-1.7B") | |
| ap.add_argument("--max-len", type=int, default=7000) | |
| ap.add_argument("--mode", default="short", choices=["short", "correctness"], | |
| help="correctness: only problems the model solves sometimes (one random correct sample each) and " | |
| "unsolved problems rescued by a checked stop; no length-only examples") | |
| args = ap.parse_args() | |
| tok = AutoTokenizer.from_pretrained(args.tokenizer) | |
| items = {} | |
| for p in glob.glob(args.items): | |
| if "sft_" in p: | |
| continue | |
| for l in open(p, encoding="utf-8"): | |
| r = json.loads(l) | |
| items[r["id"]] = r | |
| by = collections.defaultdict(list) | |
| for p in args.inp: | |
| for l in open(p, encoding="utf-8"): | |
| r = json.loads(l) | |
| by[r["id"]].append(r) | |
| out, stats = [], collections.Counter() | |
| for pid, recs in by.items(): | |
| it = items[pid] | |
| good = [r for r in recs if r["correct"]] | |
| stops = [r["stop"] for r in recs if r.get("stop", {}).get("ok")] | |
| best_short = min(good, key=lambda r: r["n_tokens"]) if good else None | |
| best_stop = min(stops, key=lambda s: len(s["tokens"])) if stops else None | |
| p_ids = tok.apply_chat_template([{"role": "user", "content": it["prompt"]}], tokenize=True, | |
| add_generation_prompt=True, return_dict=False) | |
| if args.mode == "correctness": | |
| rescue = [r["stop"] for r in recs if r.get("stop", {}).get("ok") and not r["stop"].get("from_correct")] | |
| if good and len(good) < len(recs): | |
| pick = good[zlib.crc32(pid.encode()) % len(good)] | |
| comp, kind = [t for t in pick["tokens"] if t != EOS] + [EOS], "partial" | |
| elif not good and rescue: | |
| comp, kind = [t for t in rescue[0]["tokens"] if t != EOS] + [EOS], "rescue" | |
| else: | |
| stats["skipped"] += 1 | |
| continue | |
| if len(p_ids) + len(comp) > args.max_len: | |
| stats["too_long"] += 1 | |
| continue | |
| out.append({"id": pid, "task": it["task"], "kind": kind, "prompt_ids": p_ids, "completion_ids": comp, | |
| "solved": f"{len(good)}/{len(recs)}"}) | |
| stats[f"{it['task']}_{kind}"] += 1 | |
| continue | |
| if best_stop and (not best_short or len(best_stop["tokens"]) < best_short["n_tokens"]): | |
| comp, kind = [t for t in best_stop["tokens"] if t != EOS] + [EOS], "stop" | |
| elif best_short: | |
| comp, kind = [t for t in best_short["tokens"] if t != EOS] + [EOS], "short" | |
| else: | |
| stats["no_example"] += 1 | |
| continue | |
| if len(p_ids) + len(comp) > args.max_len: | |
| stats["too_long"] += 1 | |
| continue | |
| out.append({"id": pid, "task": it["task"], "kind": kind, "prompt_ids": p_ids, "completion_ids": comp, | |
| "solved": f"{len(good)}/{len(recs)}"}) | |
| stats[f"{it['task']}_{kind}"] += 1 | |
| stats[f"len_{kind}"] += len(comp) | |
| stats[f"natural_mean_{kind}"] += sum(r["n_tokens"] for r in recs) / len(recs) | |
| with open(args.out, "w", encoding="utf-8") as f: | |
| for r in out: | |
| f.write(json.dumps(r) + "\n") | |
| for k in ("short", "stop"): | |
| n = sum(v for kk, v in stats.items() if kk.endswith("_" + k) and not kk.startswith(("len", "natural"))) | |
| if n: | |
| print(f"{k}: {n} examples, mean length {stats['len_' + k] / n:.0f} vs mean sample length " | |
| f"{stats['natural_mean_' + k] / n:.0f}") | |
| print(dict((k, v) for k, v in stats.items() if not k.startswith(("len", "natural")))) | |