Trio-Spark v1.4: unversioned model ID, current benchmarks
Browse files
README.md
CHANGED
|
@@ -19,13 +19,13 @@ license_link: https://machinefi.com/terms-of-service
|
|
| 19 |
|
| 20 |
# Trio-Spark
|
| 21 |
|
| 22 |
-
**Current release: Trio-Spark v1.
|
| 23 |
|
| 24 |
Trio-Spark is MachineFi's hosted **Situated World Model** for bounded decisions. Give it the current state and 2–8 allowed actions. One pass returns a selected action and a probability for every option, with no free-form answer to parse.
|
| 25 |
|
| 26 |
**This repository is a model card for the commercial API. Model weights and training code are not distributed here.**
|
| 27 |
|
| 28 |
-
[Try the playground](https://platform.machinefi.com/spark) · [Get an API key](https://platform.machinefi.com/login?callback=%2Fspark) · [API docs](https://
|
| 29 |
|
| 30 |
## What it does
|
| 31 |
|
|
@@ -37,7 +37,7 @@ environment signals → current state → Trio-Spark → selected action → exe
|
|
| 37 |
|
| 38 |
Your application supplies the state, legal actions, executor and safety controls. Spark handles the bounded judgment step: routing, tool selection, GUI actions, game moves, robot skills and operational decisions.
|
| 39 |
|
| 40 |
-
Input can be structured text or JSON, one image or camera frame, or a 2–4-frame sampled video window. v1.
|
| 41 |
|
| 42 |
## API quickstart
|
| 43 |
|
|
@@ -49,7 +49,7 @@ curl https://platform.machinefi.com/api/spark/v1/decisions \
|
|
| 49 |
-H "Content-Type: application/json" \
|
| 50 |
-H "Idempotency-Key: $(uuidgen)" \
|
| 51 |
-d '{
|
| 52 |
-
"model": "trio-spark
|
| 53 |
"task": "The user asked to export the current report as CSV. Choose the next safe UI action from the available controls.",
|
| 54 |
"state": {
|
| 55 |
"app": "Reports",
|
|
@@ -66,57 +66,46 @@ curl https://platform.machinefi.com/api/spark/v1/decisions \
|
|
| 66 |
|
| 67 |
Use `choice_id` to identify the selection. The response includes the complete probability distribution, confidence, a `decide`, `review` or `abstain` disposition, usage and latency. Reuse the same idempotency key and identical request body when retrying an uncertain request.
|
| 68 |
|
| 69 |
-
|
| 70 |
|
| 71 |
-
##
|
| 72 |
|
| 73 |
-
|
| 74 |
|
| 75 |
-
|
| 76 |
-
|
| 77 |
-
|
|
| 78 |
-
| -
|
| 79 |
-
|
|
| 80 |
-
|
|
| 81 |
-
|
|
| 82 |
-
|
|
| 83 |
-
|
|
| 84 |
-
|
|
| 85 |
-
|
|
| 86 |
-
|
|
| 87 |
-
|
|
| 88 |
-
|
|
| 89 |
-
|
|
| 90 |
-
| HelpSteer2 (0–4 score) (300) | 42.3 | 41.3 | 40.0 | 41.5 | 41.3 | 42.7 | 35.3 |
|
| 91 |
-
| Banking77 (77-way)† (300) | 88.1 | 80.5 | — | 80.0 | 94.6 | 94.7 | 38.7 |
|
| 92 |
-
| **Ten-task panel (2,977)** | **90.9** | **83.0** | **83.1** | **90.0** | **90.8** | **91.8** | **66.1** |
|
| 93 |
|
| 94 |
Method and limitations:
|
| 95 |
|
| 96 |
-
- Spark was evaluated through production API code
|
| 97 |
-
-
|
| 98 |
-
- † Banking77 has 77 choices and was
|
| 99 |
-
- These numbers measure text decisions. They do not establish image, video, GUI-control or real-world task performance.
|
| 100 |
-
|
| 101 |
-
See the [release post and protocol](https://machinefi.com/blog/trio-spark-v13-decisions) and [downloadable results](https://machinefi.com/spark/benchmarks/v13-launch-table-2026-10-15.json) for the complete published context.
|
| 102 |
-
|
| 103 |
-
## Version history
|
| 104 |
-
|
| 105 |
-
**v1.3 · October 15, 2026 (current).** Updated text decisions; image and sampled-video behavior unchanged. Ten-task panel 90.9% (see above). Public model ID `trio-spark-v1.3`.
|
| 106 |
|
| 107 |
-
|
| 108 |
|
| 109 |
-
|
| 110 |
-
| --- | --- |
|
| 111 |
-
| Autonomous drone | 65 s, 25 calls, 75.7 m flown, 0 collisions, course completed |
|
| 112 |
-
| Browser agent | 4.002 s, 3 calls, requested item selected, autonomous `DONE` |
|
| 113 |
-
| Robot arm | 13.68 s, 13 calls, physical success, 0 forbidden contacts |
|
| 114 |
|
| 115 |
-
|
|
|
|
|
|
|
| 116 |
|
| 117 |
## Limitations and intended use
|
| 118 |
|
| 119 |
-
|
| 120 |
|
| 121 |
Spark selects among supplied choices. It does not execute actions, operate a browser by itself, predict future frames, or provide general conversational answers. Include choices such as **wait** or **ask for review** when appropriate.
|
| 122 |
|
|
@@ -124,8 +113,8 @@ Applications remain responsible for permissions, legal-action filtering, hard sa
|
|
| 124 |
|
| 125 |
## Access and licensing
|
| 126 |
|
| 127 |
-
The hosted API is a commercial service subject to [MachineFi's terms](https://machinefi.com/terms-of-service). Text and visual input cost **$0.042 per million billed input tokens**; output is free. New accounts receive 100 free decisions.
|
| 128 |
|
| 129 |
The [public Trio-Spark repository](https://github.com/machinefi/trio-spark) contains Apache-2.0 clients and demo integrations. That code license does not grant access to model weights or training artifacts. This Hugging Face repository does not provide downloadable weights or a local-inference package.
|
| 130 |
|
| 131 |
-
|
|
|
|
| 19 |
|
| 20 |
# Trio-Spark
|
| 21 |
|
| 22 |
+
**Current release: Trio-Spark v1.4 · October 28, 2026**
|
| 23 |
|
| 24 |
Trio-Spark is MachineFi's hosted **Situated World Model** for bounded decisions. Give it the current state and 2–8 allowed actions. One pass returns a selected action and a probability for every option, with no free-form answer to parse.
|
| 25 |
|
| 26 |
**This repository is a model card for the commercial API. Model weights and training code are not distributed here.**
|
| 27 |
|
| 28 |
+
[Try the playground](https://platform.machinefi.com/spark) · [Get an API key](https://platform.machinefi.com/login?callback=%2Fspark) · [API docs](https://machinefi.com/docs) · [Pricing](https://machinefi.com/pricing) · [Demos and clients](https://github.com/machinefi/trio-spark) · [v1.4 release post](https://machinefi.com/blog/trio-spark-v14-decisions)
|
| 29 |
|
| 30 |
## What it does
|
| 31 |
|
|
|
|
| 37 |
|
| 38 |
Your application supplies the state, legal actions, executor and safety controls. Spark handles the bounded judgment step: routing, tool selection, GUI actions, game moves, robot skills and operational decisions.
|
| 39 |
|
| 40 |
+
Input can be structured text or JSON, one image or camera frame, or a 2–4-frame sampled video window. In v1.4 one model serves text, images and video. The API accepts 2–8 choices and at most 1,024 expanded input tokens, including task, state, choices and any visual input.
|
| 41 |
|
| 42 |
## API quickstart
|
| 43 |
|
|
|
|
| 49 |
-H "Content-Type: application/json" \
|
| 50 |
-H "Idempotency-Key: $(uuidgen)" \
|
| 51 |
-d '{
|
| 52 |
+
"model": "trio-spark",
|
| 53 |
"task": "The user asked to export the current report as CSV. Choose the next safe UI action from the available controls.",
|
| 54 |
"state": {
|
| 55 |
"app": "Reports",
|
|
|
|
| 66 |
|
| 67 |
Use `choice_id` to identify the selection. The response includes the complete probability distribution, confidence, a `decide`, `review` or `abstain` disposition, usage and latency. Reuse the same idempotency key and identical request body when retrying an uncertain request.
|
| 68 |
|
| 69 |
+
Use the model ID **`trio-spark`**. It always runs the current release, and each response reports the exact release in `model_version`. Earlier identifiers (`trio-spark-preview`, `trio-spark-v1.0` to `trio-spark-v1.3`) remain accepted and route to the current model; they do not pin historical weights. The [API docs](https://machinefi.com/docs) cover visual requests, errors, limits and the full response schema.
|
| 70 |
|
| 71 |
+
## Benchmarks
|
| 72 |
|
| 73 |
+
Trio-Spark v1.4 against three other fast decision models, on the same items for every model. Scores are accuracy percentages; the best score in each row is bold. Trio-Spark is best or tied for best on seven of thirteen.
|
| 74 |
|
| 75 |
+
| Benchmark (items) | Trio-Spark | Jev 1.14 | Clef-Flash | Clef |
|
| 76 |
+
| --- | ---: | ---: | ---: | ---: |
|
| 77 |
+
| AG News (300) | **90.7** | 82.7 | 88.7 | 87.0 |
|
| 78 |
+
| SST-2 (300) | **96.3** | 95.3 | **96.3** | 94.3 |
|
| 79 |
+
| TweetEval offensive (300) | **87.0** | 84.3 | 84.3 | 82.7 |
|
| 80 |
+
| Banking77 (77-way)† (300) | 88.2 | 80.1 | **94.7** | 94.6 |
|
| 81 |
+
| RTE (277) | **92.8** | 91.3 | 91.0 | 91.7 |
|
| 82 |
+
| SNLI (150) | **88.7** | 76.0 | 82.7 | 82.7 |
|
| 83 |
+
| PubMedQA (300) | **82.7** | 76.7 | 79.7 | 77.7 |
|
| 84 |
+
| BoolQ (300) | 91.7 | 90.3 | 91.7 | **92.7** |
|
| 85 |
+
| HelpSteer2 (0–4 score) (300) | **44.3** | 38.9 | 42.7 | 41.3 |
|
| 86 |
+
| ARC-Easy (300) | 97.0 | **99.7** | **99.7** | **99.7** |
|
| 87 |
+
| HellaSwag (300) | 94.7 | 94.7 | **98.7** | 98.0 |
|
| 88 |
+
| PIQA (300) | 93.0 | **95.7** | 90.3 | 91.0 |
|
| 89 |
+
| WinoGrande (300) | 89.7 | 89.3 | **98.0** | 93.7 |
|
|
|
|
|
|
|
|
|
|
| 90 |
|
| 91 |
Method and limitations:
|
| 92 |
|
| 93 |
+
- Developer-run evaluation on the listed samples, not full-dataset or independently certified leaderboard scores. Trio-Spark was evaluated through the production API code path, one request per item; requests rejected by the input limit or content filter count as wrong.
|
| 94 |
+
- Jev 1.14 through its official API on October 28, 2026; Clef and Clef-Flash recorded October 7–8, 2026. HelpSteer2 and Banking77 peer scores average five orderings of the options.
|
| 95 |
+
- † Banking77 has 77 choices and was read out offline from the same weights; the public API accepts at most 8 choices per request.
|
| 96 |
+
- These numbers measure text decisions. They do not establish image, video, GUI-control or real-world task performance.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 97 |
|
| 98 |
+
The [release post](https://machinefi.com/blog/trio-spark-v14-decisions) has the full protocol, and the [downloadable results](https://machinefi.com/spark/benchmarks/v14-launch-table-2026-10-28.json) include every count.
|
| 99 |
|
| 100 |
+
## Releases
|
|
|
|
|
|
|
|
|
|
|
|
|
| 101 |
|
| 102 |
+
- **v1.4 · October 28, 2026 (current).** One model for text, images and video; served as `trio-spark`.
|
| 103 |
+
- **v1.3 · October 15, 2026.** Text decision update.
|
| 104 |
+
- **v1.0 · September 30, 2026.** First release, with replayable [drone, browser and robot-arm demos](https://github.com/machinefi/trio-spark).
|
| 105 |
|
| 106 |
## Limitations and intended use
|
| 107 |
|
| 108 |
+
Evaluate Spark on your own screens, frames and actions before increasing automation. Latency depends on the request and workload; nothing on this card is a latency guarantee.
|
| 109 |
|
| 110 |
Spark selects among supplied choices. It does not execute actions, operate a browser by itself, predict future frames, or provide general conversational answers. Include choices such as **wait** or **ask for review** when appropriate.
|
| 111 |
|
|
|
|
| 113 |
|
| 114 |
## Access and licensing
|
| 115 |
|
| 116 |
+
The hosted API is a commercial service subject to [MachineFi's terms](https://machinefi.com/terms-of-service). Text and visual input cost **$0.042 per million billed input tokens**; output is free. New accounts receive 100 free decisions. See [pricing](https://machinefi.com/pricing) for current details.
|
| 117 |
|
| 118 |
The [public Trio-Spark repository](https://github.com/machinefi/trio-spark) contains Apache-2.0 clients and demo integrations. That code license does not grant access to model weights or training artifacts. This Hugging Face repository does not provide downloadable weights or a local-inference package.
|
| 119 |
|
| 120 |
+
Research weights: [MachineFi/Trio-Spark-DI-1.4](https://huggingface.co/MachineFi/Trio-Spark-DI-1.4) is a text-only Q8_0 build of the v1.4 model the API serves, released under CC BY-NC 4.0 for research and evaluation.
|