Raullen commited on
Commit
821669d
·
verified ·
1 Parent(s): 68d73a8

Trio-Spark v1.4: unversioned model ID, current benchmarks

Browse files
Files changed (1) hide show
  1. README.md +34 -45
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.3 · October 15, 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://platform.machinefi.com/spark/docs) · [Demos and clients](https://github.com/machinefi/trio-spark) · [v1.3 release post](https://machinefi.com/blog/trio-spark-v13-decisions)
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.3 updates text decisions; image and sampled-video behavior is unchanged. 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,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-v1.3",
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
- The recommended public model ID is **`trio-spark-v1.3`**. Older aliases remain compatible and route to the current served model; they do not pin historical weights. See the [API docs](https://platform.machinefi.com/spark/docs) for visual requests, System One compatibility and the full response schema.
70
 
71
- ## v1.3 evaluation snapshot
72
 
73
- On a ten-task panel of **2,977 decisions**, v1.3 scored **90.9%** (2,706 correct), versus 83.1% for v1.0 and 83.0% for v1.2. Its expected calibration error on that panel, using 10 bins, was **0.019**.
74
 
75
- The following developer-run evaluation uses the same items for each model. Scores are accuracy percentages on the listed samples, not full-dataset or independently certified leaderboard scores. The ten-task total covers the first ten rows; the remaining three rows are additional evaluations.
76
-
77
- | Task (items) | Spark v1.3 | Spark v1.2 | Spark v1.0 | Jev 1.13 | Clef | Clef-Flash | Laya |
78
- | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
79
- | AG News (300) | 90.3 | 83.0 | 83.3 | 82.7 | 87.0 | 88.7 | 91.7 |
80
- | ARC-Easy (300) | 98.3 | 95.7 | 95.0 | 99.0 | 99.7 | 99.7 | 48.0 |
81
- | BoolQ (300) | 91.0 | 87.0 | 87.3 | 92.0 | 92.7 | 91.7 | 80.7 |
82
- | HellaSwag (300) | 93.7 | 80.7 | 80.3 | 95.0 | 98.0 | 98.7 | 28.3 |
83
- | PIQA (300) | 88.0 | 78.0 | 82.0 | 95.7 | 91.0 | 90.3 | 53.7 |
84
- | PubMedQA (300) | 81.0 | 70.3 | 67.3 | 77.0 | 77.7 | 79.7 | 57.0 |
85
- | RTE (277) | 94.2 | 88.8 | 89.2 | 91.7 | 91.7 | 91.0 | 83.0 |
86
- | SST-2 (300) | 95.3 | 93.7 | 94.0 | 95.3 | 94.3 | 96.3 | 91.0 |
87
- | TweetEval offensive (300) | 86.3 | 81.7 | 82.7 | 82.3 | 82.7 | 84.3 | 78.3 |
88
- | WinoGrande (300) | 91.0 | 72.0 | 70.7 | 89.3 | 93.7 | 98.0 | 50.3 |
89
- | SNLI (150) | 85.3 | 84.0 | 63.3 | 75.3 | 82.7 | 82.7 | 46.0 |
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 and its model server, one request per item. Requests rejected by the input limit or content filter count as wrong.
97
- - Peer results came from official APIs or the official SDK, recorded October 7–8, 2026. HelpSteer2 and Banking77 peer scores average five option orderings.
98
- - † Banking77 has 77 choices and was evaluated offline; it is not a supported 77-choice request to the public API. v1.0 was not measured on this row.
99
- - These numbers measure text decisions. They do not establish image, video, GUI-control or real-world task performance. Calibration on this panel does not guarantee calibrated confidence in a different application.
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
- **v1.0 · September 30, 2026.** First release, served as `trio-spark-preview` (the alias now routes to the current model). Launch evaluation on the production API: SST-2 92.89%, AG News 88.46%, PubMedQA 85.33%, TweetEval 80.58% ([launch post](https://machinefi.com/blog/trio-spark-decisions-single-pass)). Replayable demo runs from the [public demo repository](https://github.com/machinefi/trio-spark):
108
 
109
- | Environment | Result |
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
- These demos send structured environment signals to Spark; they do not claim direct control from raw pixels. The former `MachineFi/Trio-Spark-v1.0` card is merged into this page.
 
 
116
 
117
  ## Limitations and intended use
118
 
119
- v1.3 scores below v1.0 on MachineFi's internal GUI-action suite despite improving on the published text panel. Evaluate it on your own screens and actions before increasing automation. Latency depends on the request and workload; the evaluation table is not a latency guarantee.
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. Refer to the console for current access and billing details.
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
- Open research weights: [MachineFi/Trio-Spark-DI](https://huggingface.co/MachineFi/Trio-Spark-DI) is a separate, text-only research checkpoint for the Decision Index, released under CC BY-NC 4.0. It is not the model the API serves.
 
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.