ThoxNeedle-Micro
On-Device Function Calling for THOX Hardware — a THOX-trained function-calling model for THOX hardware, packaged in the .cact format the device runtime loads
Function-calling for THOX device tools · .cact device format (13.7 MB) · Empty-call discipline for unservable requests
Your AI. Your Data. Your Rules.™
Status: PUBLISHED. A THOX-trained function-calling model for THOX hardware, shipped in the .cact device format (not GGUF). Held-out evaluation is printed in full under Evaluation. See Files for exactly what this repo contains.
Summary
ThoxNeedle-Micro is a THOX-trained function-calling model for THOX hardware, packaged in the .cact format the device runtime loads. Given a set of THOX device tool schemas and a user request, it emits the tool call that satisfies the request, or an empty call list when no available tool can serve it. That second behaviour is a first-class objective: on a device, a model that invents a plausible-looking call for an unservable request fires real actuators.
Highlights
- ThoxNeedle-Micro is a THOX-trained function-calling model for THOX hardware, packaged in the
.cactformat the device runtime loads. - This repo ships
.cactweights, not GGUF; run them with the Cactus runtime on a ThoxOS phone or host.
Specifications
| Base model | Cactus-Compute/needle2 |
| Parameters | See card body |
| License | Apache-2.0. The THOX fine-tune and additions in this repo are covered under Apache-2.0; see the license text for terms. |
| This repository contains | Packaging and documentation — see Files table |
Files
| File | Size | SHA-256 |
|---|---|---|
needle2.cact |
13,737,679 B | cd53ef1b89c70c78aa4bff749733d86b0a9314bf65512139ad63f1280267ca81 |
training/artifacts/base.cact |
13,737,679 B | 0993bd2ca03bf43f089aa85087f57bb11ce1041f20a9d6772a4fbc6456308f36 |
training/artifacts/thoxneedle-micro.cact |
13,737,679 B | cd53ef1b89c70c78aa4bff749733d86b0a9314bf65512139ad63f1280267ca81 |
training/artifacts/thoxneedle_micro_lora.pkl |
8,259,236 B | 469c3b8b19631bca675878561f8d06fc659f4b004c1c4f98e189c58b3672de45 |
needle-tooluse.jsonl / training/eval/eval_report.json / training/eval/quant_delta.json / training/eval/loss_curve.json / training/data/splits.json / LICENSE / training/eval/sweep_lr0.001.json / training/eval/sweep_lr0.0003.json / training/artifacts/MODEL_CARD.md / UPSTREAM_ISSUE.md / training/eval/sweep_lr3e-05.json / training/eval/sweep_lr0.0001.json / .gitattributes / config.json / … |
— | Supporting files (see repo) |
Run it
This repo ships .cact weights, not GGUF; run them with the Cactus runtime on a ThoxOS phone or host. There is no llama.cpp / Ollama path for .cact files.
hf download Thox-ai/ThoxNeedle-Micro --include "*.cact" --local-dir ./ThoxNeedle-Micro
Platforms
| Platform / device | Run path |
|---|---|
| Hugging Face | Download the builds listed under Files from this repo (see Run it) |
Training data and procedure
LoRA fine-tune (rank 16) on a THOX-authored corpus of 1,400 device tool-calling examples, split group-aware (1,145 train / 255 held out) so no example appears on both sides. The fine-tune's changes survive the deployment quantization: 58.38% of weight elements changed versus the passthrough build, verified by dequantizing and diffing both artifacts.
Evaluation
Held-out set: 255 distinct examples, greedy decoding. Exact match and refusal accuracy are reported separately because averaging them would hide the failure mode that matters on a device.
| Metric | Base (passthrough) | THOX fine-tune | Delta |
|---|---|---|---|
| Well-formed output | 98.04% (250/255) | 100.0% (255/255) | +1.96 |
| Correct tool selected | 60.78% (155/255) | 85.88% (219/255) | +25.10 |
| Exact match (name + args) | 54.12% (138/255) | 85.1% (217/255) | +30.98 |
| Exact match, call examples only | 47.01% (55/117) | 79.49% (93/117) | +32.48 |
| Refusal accuracy (empty call list) | 60.14% (83/138) | 89.86% (124/138) | +29.72 |
Read these deltas with the sample size in mind: one example is 0.39 percentage points, so single-example movements are not trends this set can resolve. No THOX GATE49 result is published for this model.
Intended use
- Local, on-device function calling for THOX hardware against THOX device tool schemas.
- Out of scope: medical, legal, financial, safety-critical, or other high-stakes decisions without human review; unattended control of physical devices without a confirmation step.
Limitations
- The training corpus is small (1,400 examples), which caps what any fine-tune of it can demonstrate; expanding it is the prerequisite for a meaningful improvement.
- Tool schemas outside the trained THOX device set are out of scope; the model should refuse them, and refusal accuracy is 89.86%, not 100%.
- Behaviour and bias reflect the training data, which is mostly English; quality in other languages is lower.
License
Apache-2.0. The THOX fine-tune and additions in this repo are covered under Apache-2.0; see the license text for terms.
THOX.ai — Your AI. Your Data. Your Rules.™
Provenance
Published by THOX.ai as Thox-ai/ThoxNeedle-Micro. THOX from-scratch research line; no upstream base model. This card was conformed to THOX Model Card Standard v1.0 on 2026-10-31 (frontmatter, tags, header, files, and section structure); the technical content is as published at release.
Citation
@misc{thoxai2026thoxneedlemicro,
title={ThoxNeedle-Micro},
author={THOX.ai},
year={2026},
url={https://huggingface.co/Thox-ai/ThoxNeedle-Micro}
}