Tinker Compatibility Roadmap

This page lists only Tinker-compatibility interfaces. Items marked Live are available; items marked Planning are not yet implemented.

Current practical migration rule

For ordinary Tinker-style experiments on MinT, the lowest-friction migration is:

import mint as tinker

Then switch the API key and base URL to MinT.

Why this is the recommended rule:

raw upstream import tinker still validates the tml- API key prefix locally
MinT API keys start with sk-
import mint as tinker keeps the Tinker-style code shape while enabling the MinT compatibility layer

If you must keep the exact import tinker statement, import mint earlier in the same process before constructing Tinker clients.

Last updated: April 9, 2026

Interface	Status	Notes
create_lora_training_client (create_model)	Live	Core training client creation
forward / forward_backward / optim_step	Live	Core training loop
save_weights_for_sampler	Live	Export weights for sampling
create_sampling_session	Live	Session-based sampling
compute_logprobs + prompt_logprobs/topk_prompt_logprobs	Live	Prompt logprobs support
get_info / get_tokenizer	Live	Model metadata / tokenizer
save_state + TrainingClient.load_state_with_optimizer	Live	Optimizer-preserving resume uses explicit `create_lora_training_client(...)` + `load_state_with_optimizer(...)`
create_training_client_from_state	Live	Weights-only load path; optimizer state resets
forward_backward_custom	Live	Client-side custom loss path built on `forward` + `forward_backward`
RestClient training runs & sessions	Planning	get_training_run / list_training_runs / get_session / list_sessions / get_sampler
RestClient checkpoints + canonical tinker paths	Planning	publish/unpublish/list_user_checkpoints + tinker://.../weights/...
/sampling_clients/save_and_create	Planning	Combined save+create endpoint
sampling_session_seq_id / seq_id	Planning	Deterministic multi-turn sampling
Multi-turn renderer system	Planning	Renderer parity with Tinker cookbook

For a real MinT checkpoint workflow, see Advanced / Checkpoint.
For session-level Seq-MIS rollout-correction validation, see Advanced / MIS Rollout Correction.
For a runnable pairwise preference example using forward_backward_custom, see Loss Functions.
For the MinT-only OpenPI / VLA SDK path, see OpenPI VLA SDK. This lives under mint.mint / mintx, not the Tinker-compatible default namespace.
For the raw wire format behind that helper, see OpenPI VLA HTTP.

These advanced pages document working MinT-side workflows. They do not imply full Tinker parity beyond the status table above.