Your first study in
MatrixAI Studio

A real walkthrough of the current Studio: frame a problem, watch the engines compete, read why one wins, use it and take it with you. Every screenshot comes from a live session, in this language, with a measured public example.

FrameCompeteResultsEvidence and receiptUseTake it with you
The captures show one real study: the public example climate-model-simulation-crashes (UCI, 540 rows), in “Quick” mode. The figures belong to that study on that machine: they illustrate the screen and are not the Phase 0 measurement.
Before you start — Requirements
Docker Desktop
Mac / Windows · Linux: Docker Engine + Compose v2 · Free download ↗

That's it. MatrixAI Studio runs entirely inside Docker, on your own machine: your data does not leave it, except what you choose to send to your own LLM.

01
Set up the study

Frame the problem, or load an example

The first screen of the study: you reach it from the Studio’s home page with “Try the study”. A study does not train one model: it frames the problem, makes several candidates compete and picks one — or says none is good enough. You can start from a form example (a few invented rows, only to see what goes in each field), from a measured example (a real public dataset) or from your own CSV. Saved studies are listed above and survive a restart. The rest of the tour follows one measured example: climate-model-simulation-crashes, 540 rows from UCI.

Framing screen: the form examples and, below them, the measured examples with what each is for, what it returns and its source; the one this tour uses, climate-model-simulation-crashes (540 rows), starts at the bottom edge
Framing screen: the form examples and, below them, the measured examples with what each is for, what it returns and its source; the one this tour uses, climate-model-simulation-crashes (540 rows), starts at the bottom edge
02
Set up the study

Choose what to predict

The target column, the kind of problem (two classes, several classes or a number), which class is the positive one, what one row stands for and the moment the prediction is made. The Studio does not fill in what it cannot know: without the unit of observation the study does not start. In the first screenshot the form was filled in from the measured example: the target column (outcome), binary classification and the positive class (0, a simulation that fails) are what MatrixAI measured in Phase 0. Optional: if you have an LLM configured, a box on top of the form (“Let the LLM propose the fields”) asks it to propose the empty fields from the column names, a few counts for each column and 5 real rows of your CSV. In the second screenshot it has done so, on an empty form with the CSV loaded: each proposed field carries a “Proposed by the LLM” mark until you edit it, nothing is confirmed, and what is already written is left alone. Check what it proposes: here it proposed 1 as the positive class, where the measured example uses 0.

The “What is being predicted” form filled in from the measured example: its note (46 of 540 runs fail), the “Let the LLM propose the fields” box, and the target column (outcome), problem type and positive class (0)
The “What is being predicted” form filled in from the measured example: its note (46 of 540 runs fail), the “Let the LLM propose the fields” box, and the target column (outcome), problem type and positive class (0)
The empty form with “Let the LLM propose the fields” ticked: the notice lists what was proposed and says that 19 columns and 5 rows were sent to openai (gpt-4o-mini); the proposed fields carry the mark “Proposed by the LLM”, and the positive class proposed is 1
The empty form with “Let the LLM propose the fields” ticked: the notice lists what was proposed and says that 19 columns and 5 rows were sent to openai (gpt-4o-mini); the proposed fields carry the mark “Proposed by the LLM”, and the positive class proposed is 1
03
Set up the study

Confirm the objective and start

Confirm objective checks the framing against your data before anything runs; Start the study launches it. Optionally you can say how this is decided today and what a mistake costs. “Kind of study” chooses between Full — every option of this Studio competes, neural networks included — and Quick, the one in the capture: it runs only LightGBM, scikit-learn HGB and the baseline, does not train the networks and may leave out one that would have won. The protocol is the same in both: the same exam data, the same split and the same time for each engine.

The end of the framing form: the “How is it decided today” options, the Confirm objective button, “Kind of study” set to “Quick (no neural networks)” and the Start the study button
The end of the framing form: the “How is it decided today” options, the Confirm objective button, “Kind of study” set to “Quick (no neural networks)” and the Start the study button
04
The study runs

The engines compete

Each engine is tried on several parts of the development data with its own cross-validation, and the test set stays untouched until the end. The screen counts attempts as they finish — here 3 of 15: in Quick mode three engines compete, LightGBM, scikit-learn HGB and the baseline, with five parts each — and you can cancel at any time. It also gives the time estimated when the study started (an estimate, not a measurement or a promise) and how long it has been running, and lists the parts finished under each engine. In Full mode the neural networks compete too, and they add attempts to that count.

The study in progress: 3 of 15 attempts completed, the estimated time (usually about 79 s, in a high case about 100 s), the parts finished under LightGBM, scikit-learn HGB and the baseline, and the Cancel the study button
The study in progress: 3 of 15 attempts completed, the estimated time (usually about 79 s, in a high case about 100 s), the parts finished under LightGBM, scikit-learn HGB and the baseline, and the Cancel the study button
05
Results

The champion — and why

Results opens with the recommendation: the champion by its engine name (here LightGBM), what that engine is, and the reason in plain words. When the paired comparison against the runner-up does not show an improvement, the screen says so, as it does here: it is a choice under uncertainty, not a clear winner. A card says what the engine was measured against in Phase 0. Save this study sits right here.

Results: “Champion: LightGBM”, the note that the choice is made under uncertainty, the “Supported engine” mark with its Phase 0 card, and the Save this study button
Results: “Champion: LightGBM”, the note that the choice is made under uncertainty, the “Supported engine” mark with its Phase 0 card, and the Save this study button
06
Results

Its figure on the held-out test

The figure that counts comes from data no candidate saw while competing: here AUROC, accuracy and specificity on the independent held-out test (108 rows), plus how the delivered model was trained and calibrated, how the rows were split and how long a prediction takes on this machine. These figures belong to this one study, run in Quick mode on this machine: read them as the screen, not as the Phase 0 measurement; what we measured for real is in “How we measure”.

The Result card: “independent held-out test”, AUROC 0.964, accuracy 0.944 and specificity 0.99, how the model was trained and calibrated (367 of 432 development rows), how the rows were split, and the prediction speed
The Result card: “independent held-out test”, AUROC 0.964, accuracy 0.944 and specificity 0.99, how the model was trained and calibrated (367 of 432 development rows), how the rows were split, and the prediction speed
07
Results

The comparison

Every engine appears once, with its parts. Next to each one, the mean over its parts — the one that decides — and the range between the best and the worst part, so a lucky single split cannot pick the champion. For engines measured before, a card says what they were measured against in Phase 0. Here the means of the two best engines are very close, which fits the note of the previous step.

The Comparison section: LightGBM (mean over its 5 parts, AUROC 0.939 — the one that decides — and a range from 0.884 to 0.979) and scikit-learn HGB (0.937, from 0.861 to 0.995), each with its Phase 0 card; the baseline starts at the bottom edge
The Comparison section: LightGBM (mean over its 5 parts, AUROC 0.939 — the one that decides — and a range from 0.884 to 0.979) and scikit-learn HGB (0.937, from 0.861 to 0.995), each with its Phase 0 card; the baseline starts at the bottom edge
08
Results

The evidence and the receipt

Below the comparison, the evidence says what applies and what does not (manifest and signature checks, usage card) and why: here neither applies, because the candidate is a checkpoint that was never published as a full registry model and the usage card needs text written by a person, which this automatic study does not collect. The receipt records what competed and why it won. It comes out signed with the Ed25519 key of this installation, created the first time it is needed; the screen shows the fingerprint of that key and where it comes from. An HMAC signature with your own shared key stays optional. The signature says which installation signed it and that nobody has touched it since, not that the model is right, and it does not raise the receipt's level.

The Evidence section and the Receipt: “Carries an Ed25519 signature”, the fingerprint of the key that signed it and, below, the signing key of this installation (“Key created by the Studio for this installation”)
The Evidence section and the Receipt: “Carries an Ed25519 signature”, the fingerprint of the key that signed it and, below, the signing key of this installation (“Key created by the Studio for this installation”)
09
Results

Save the study

Save this study keeps it apart, under “Saved studies”: it is not a model, it is not edited or retrained like one, and it survives a server restart. From there you reopen it to keep testing it and to take it with you.

After clicking Save this study: “Saved. You can come back to it from Saved studies when you start another one.”
After clicking Save this study: “Saved. You can come back to it from Saved studies when you start another one.”
10
Use and take it with you

Try a row

Use starts with a row filled in with the sample value the study left — the median of each numeric column and the most frequent category of each categorical one. Change them to the case you want to try and press Try: you get the prediction, the calibrated and the raw probability, the study threshold, and a warning when a value falls outside what the model saw while training. Below the answer, “Explain this row” says which columns pushed it, and a ranking shows which columns the winning model used most.

Try a single row: one field per column (vconst_corr, vconst_2…) with a slider and, under each, its median and its range at training time
Try a single row: one field per column (vconst_corr, vconst_2…) with a slider and, under each, its median and its range at training time
The answer for the sample row: prediction 1, calibrated probability 0.2%, raw probability < 0.01%, study threshold 62.5%, the answer with 90% coverage and the note that every value is within what the model saw; below, “Explain this row” and the columns that weigh in this model
The answer for the sample row: prediction 1, calibrated probability 0.2%, raw probability < 0.01%, study threshold 62.5%, the answer with 90% coverage and the note that every value is within what the model saw; below, “Explain this row” and the columns that weigh in this model
11
Use and take it with you

Predict a whole CSV

Choose a CSV with the same columns, press Predict and every row is predicted, with a count of how many were predicted and how many failed. Download the result as a CSV.

A second CSV, in batch: “3 rows — 3 predicted, 0 with an error”, the note that every row is within what the model saw at training time, and the Download CSV button
A second CSV, in batch: “3 rows — 3 predicted, 0 with an error”, the note that every row is within what the model saw at training time, and the Download CSV button
12
Use and take it with you

Take the winner’s package

Build the package creates the model, its preparation and a predict.py that predicts like this screen does, outside the Studio, with Python (it needs the Studio’s engines, which are not on PyPI). The screen lists what has been checked about it and what has not, with the reason: here the package integrity is checked, and the other checks say “Not checked” and why (an inference package carries no per-row predictions nor the training data). A page that predicts in the browser (ONNX) is offered only when the winner is LightGBM on a binary problem, with a decision made and no date columns; when it is not possible, the option appears switched off with its reason. To show the model to someone who does not have the Studio, Results also generates a Living Report: it is the next step.

“Save and take the model with you”: package ready (inference profile, 11 files), its download link (0.1 MB) and the list of what has been checked about it: package integrity checked, the rest not checked, each with its reason
“Save and take the model with you”: package ready (inference profile, 11 files), its download link (0.1 MB) and the list of what has been checked about it: package integrity checked, the rest not checked, each with its reason
13
Use and take it with you

Take the whole study to another Studio

Build the full study makes estudio-completo.zip: the comparison between candidates, its score and the winning model. It also carries data of yours, readable by whoever receives it, and the screen lists it before you build (up to 2,000 rows of the held-out test without the target column, the distinct values of the categories, the minimum, maximum and median of each numeric attribute…). You download it, and you reopen it in another Studio — or in this one after reinstalling — with “Open a study you already have”.

“Take this study to another Studio”: the list of data of yours it also carries, the full study built (estudio-completo.zip) and its download link (0.2 MB)
“Take this study to another Studio”: the list of data of yours it also carries, the full study built (estudio-completo.zip) and its download link (0.2 MB)
14
Use and take it with you

The Living Report

To show the model to someone who does not have the Studio, Results offers a Living Report right below the dossier: “Generate the Living Report” writes a single signed .html file that opens with a double click, without internet. It carries the study card, the curves of the held-out test and a page to try and explain a row — and, in a binary problem, the decision map and the simulator. Two boxes let you remove the brand footer and the large vocabularies. When it is done, the screen shows the file’s integrity fingerprint (SHA-256) — which is not a signature: whoever edits the file can recompute it — and, apart from it, the Ed25519 signature of that fingerprint, with the fingerprint of the key that signed. This screen does not check it: whoever receives the file can, on this website’s “Check a signature” page, in their browser, uploading nothing. A valid signature says the file has not changed since it was signed, not that the model is right. It is offered when a tree model wins, in binary, multiclass and regression studies without date columns; when it cannot be made, the button appears switched off with its reason. The second screenshot is the downloaded file, opened in the browser.

The Living Report block in Results, once generated: the file’s name and size, its integrity fingerprint, and the Ed25519 signature with the fingerprint of the key
The Living Report block in Results, once generated: the file’s name and size, its integrity fingerprint, and the Ed25519 signature with the fingerprint of the key
The downloaded Living Report, opened in the browser without the Studio: its “Study card” tab, with the practical reading on the 108 held-out rows, the winning model (LightGBM), the data (climate-model-simulation-crashes) and “Receipt signed: yes”, and the other tabs: Decision map, Simulator, Curves, Try and explain a row, and What travels in this file
The downloaded Living Report, opened in the browser without the Studio: its “Study card” tab, with the practical reading on the 108 held-out rows, the winning model (LightGBM), the data (climate-model-simulation-crashes) and “Receipt signed: yes”, and the other tabs: Decision map, Simulator, Curves, Try and explain a row, and What travels in this file
15
Expert mode

And expert mode?

It is still in the product, behind a switch: “Turn on expert mode” on the Studio’s home screen. There you describe a model in a sentence, upload a CSV or start from a template and go through its phases one by one: the core builds that network, phase by phase. Separately, the classic interface (in the top bar) and the Workbench (in Settings) remain in the package. It is a different way of working from the study, and its manual explains it phase by phase.

Expert mode: the phases manualIncluded in the Studio

One model from a sentence or a CSV, phase by phase — model, data, training, audit, test and deployment — with what each phase reports and what it says it does not do. It also tells you how to switch to it.

One tool, two ways

Get MatrixAI Studio

One download, one script, your instance running locally in minutes. No data leaves your machine.

Get started ↗